gmane.linux.redhat.fedora.documentation

Re: Efficient Storage of Media Files

Christopher R. Antila — 2012-05-25T00:08:58

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

On 05/24/2012 11:56 AM, Eric Christensen wrote:

But we were planning an adventure!
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.12 (GNU/Linux)

iQEcBAEBAgAGBQJPvs2VAAoJEInCktGVqZ8Vk3YH/2X+WbIBwv0KRPDvaVEvvMYh
QBDWcHI69NRwuUedU0Gi/9918FQB4+Y8gg+LISt5mtYyu2pY/i3HE6dbY5M3plru
vVL7C0HHhRcOiEjbFc8d8KbINJQY93S2KoS5dL7plusBzUbusDQFHOzCkPvPPnw7
jJEsBOYQN9YVx6ynDVC+fQc0zigiSh671fhufOXycJloLWDe74gLrNkPQLqPWP28
gchP557JiZDY8SrtvvufekDRZ4YkB/QiI61f4aRoOCAtIcBGytk3fb4Cpcf4Parc
8M2Oj+hfBFLXqwCGyZAXGbqF/VsNlXOfFEEklbOUT+OsTxjhAR4BVBvHpOiqgXM=
=NbQf
-----END PGP SIGNATURE-----

Re: Efficient Storage of Media Files

Eric Christensen — 2012-05-24T15:56:13

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

On 05/23/2012 10:32 PM, Ruediger Landmann wrote:

I spoke with Dennis Gilmore this morning about getting a separate koji
instance for Docs.  Looks like doing this will be a lot easier than
what we were thinking:


<Sparks> What would be required to stand up a separate instance of
koji for Docs?
<dgilmore> Sparks: why would you want a seperate instance?
<dgilmore> Sparks: i dont see any valid reason to do so
<Sparks> dgilmore: For the Docs website.  Publican has the ability
publish documentation from packages (separate repo from the Fedora
repo) for the website.  We want to replace the git repo that operates
it now.
<dgilmore> Sparks: and why does that need a seperate koji?
<Sparks> The git repo has gotten HUGE and is becoming an issue.
<dgilmore> Sparks: so, why does that mean a seperate koji instance
<dgilmore> Sparks: we could use a seperate tag and targets in koji
<dgilmore> i dont see why it would need its own koji
<Sparks> dgilmore: It's either that or try to get everyone setup as
packagers.
<dgilmore> Sparks: get everyone setup as packagers
<Sparks> dgilmore: Except that they really won't be packagers.
<dgilmore> Sparks: though you dont need to be a a packager to get a
koji cert
<dgilmore> you just need fas
<dgilmore> Sparks: what would be the workflow?
<Sparks> dgilmore: Okay, and with that we can send packages through
koji and tag them separately?
<Sparks> dgilmore: Basically we just tell Publican to build the
package and submit it to koji.  The Publican software does all the work.
<dgilmore> Sparks: I still really dont know what your trying to do.
pretend im an idiot(not really that hard) and explain what it is and
how it should work
<Sparks> dgilmore: I'm not far off...
<Sparks> dgilmore: So Publican will make an SRPM package, submit it to
koji destined for a repo.  Our Publican backend will install those
packages and publish the data to the website.
<Sparks> ...as I understand it
<dgilmore> Sparks: so we would need to set up seperate tags and tagets
for it, defining a koji policy allowing srpms to be built. likely we
would add a new group to koji and add people allowed to build docs to
it and limit access to the tags/targets to people in that group
<dgilmore> Sparks: so its all doable
<Sparks> dgilmore: Well that's a lot easier.  :)
<Sparks> dgilmore: We already have a group in FAS for people that
should have access (docs-publishers).  Should I open a ticket?
<dgilmore> Sparks: koji doesnt know anything about fas
<dgilmore> Sparks: please file a ticket. We wont be able to make
changes until after f17 is done
<Sparks> dgilmore: That's fine.  We're not completely ready for the
transition so after F17 would be good.
<Sparks> dgilmore: Thanks!
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.12 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/

iQIcBAEBAgAGBQJPvlodAAoJEIB2q94CS7PRn8gQAISXFCHaFFLY4zqZibkhef4i
wXjMPCXGpwunRo4VvBpH3irFuz8r5tFVMwH8GL/6yHYmtIuIZ9dWjfUwFDhav/6K
plhukDHC183HaNdiKk6YmEbbGHHJ972xpo4mE/Db0Xh7aLL8qZfXjIos9zrKaHAG
ZndiQrKhYvk5n2wGdaFO5n5WPc8kVBXnTDj2bdTLgqZyiG54iES8CmbGTImc20KF
8jjNCD5JujK1eo6dQAk4KZQ9kZNvGNDyq7C8fT4hFcLGvi6W4W1L2um3pIxUF1PG
lSTRfu1oHOyHpP7fb9/r9NZnE8AK/5Sj6QDHtAFFE10JlYJXdCynki1hlMpSRB4d
D7eoK2tMrpMJyLLqPW3lLpv7EtsqhSqXT6wXG0CewkBcV28vEQaUEIGzErI7Mb2/
5ePV56jKo89E1qJtGmdlPF+z8PWZXvFkkoRbXuu+NrlVP4xzqaQYg42OynNf7ZaA
0bI8srdDk2Iw8eFoizpWmYYtZkyncq3KfbveF6ih1NZ/qax0hpvhu8/w3bAHCSAv
EQYasEriWFHmcCu8VWvPw32AaBkmM7MVYqz8EV5T0M6Wy1M/Jtd7oI1KEnUS777I
3gS4LESFBT1BG2Ua8qjEkA7GKmsAvlU68nvmIiOQ4Xb43O7MPaAN5iNFwCJHLF4b
rpjncaFWNNIbXfIHk3TN
=D9bJ
-----END PGP SIGNATURE-----

Re: Efficient Storage of Media Files

Alexander Moore — 2012-05-24T04:19:23

I am in the same boat with Christopher.

On Wed, May 23, 2012 at 8:57 PM, Christopher R. Antila <
crantila< at >fedoraproject.org> wrote:

Re: Efficient Storage of Media Files

Christopher R. Antila — 2012-05-24T03:57:41

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

On 05/23/2012 10:32 PM, Ruediger Landmann wrote:

I am! I don't know if I can, time-wise and programming language-wise,
but that's not what you asked.


Christopher.
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.12 (GNU/Linux)

iQEcBAEBAgAGBQJPvbGvAAoJEInCktGVqZ8VgQAH/1guB2AlqMYDYQO32tPka5ZW
SLUxArMbu50hZQ+14VA7bKulTL3xP0sEp1jPyEDve4GaKtVhxDaW38pPYR6jMBQF
THRPHsXPur0H5aw8bPmZZdnQ7gxFX3KF+zSFQK10MWUBADehjatk0ob7+BU5Eo42
xOKe59NwJC9hbqOobvNUAI/GwaLBepGRj7NzkCN0nOqfSDB+UgTC99zuh+1seCnw
YYjoeSsOSebqXhpkGhbrYt4Uk+9H+IapUmG2suhPVn4SxHoQyEj+v8xXBXk2MPzf
2wYFIQTVWVXUvZyBcmSp8CZQ429bUKAVDbPd1TitxCVIxRqeXeSJOZ5JHmOyMA4=
=S/fM
-----END PGP SIGNATURE-----

Re: Efficient Storage of Media Files

Ruediger Landmann — 2012-05-24T02:32:41


That would (kinda) solve the problem for now; but the deeper underlying 
problem is that I think we're reaching the limit of what we can sensibly 
do with Git :)

This was only ever a stop-gap mechanism while we implemented proper 
packaging for the docs; unfortunately, like many systems that work "well 
enough", we never got to replacing it.

Personal admission: it was actually my personal goal during my year on 
the board to make this happen, but I never got to it ;)

So: what do we need?

1. I think the procedural obstacles to getting every writer and 
translator access to Koji are probably bigger than we want to handle. We 
therefore need to stand up a build system of our own. Ideally, this 
would be a Koji instance of our own: the benefit of Koji is that it 
insulates the build process very well from issues that might be specific 
to people's own machines. If that's too much work to pull off in the 
short term, we should simply create a build server with current publican 
and publican-fedora installed on it, and access granted to anyone in the 
docs-publishers group. Packages built on this machine would be placed in 
a repo.

2. We would need to modify the staging server that currently pulls our 
docs.git to instead install packages built on the build server.

I think that if we pull together, we should be able to get this up and 
running reasonably soon. Who's interested in collaborating on a project 
like this?

Cheers
Rudi

Re: Efficient Storage of Media Files

Ben Cotton — 2012-05-23T23:27:06

It seems like a good candidate for being hosted outside of git. Perhaps we
could get some space on fedorahosted.org for the files?

Efficient Storage of Media Files

Christopher R. Antila — 2012-05-23T22:22:36

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Hello:

Several weeks ago, somebody wrote to the list about the continually
growing size of the Docs web.git repository. I took a look around, and
confessed that most of the storage is taken up by multiple copies of
the Musicians' Guide. It's time to fix this.

I uploaded the audio files to SoundCloud long ago, but I don't think
we should use them as our primary place to hose this content. For the
"Ardour" chapter, we cannot host the files for licensing reasons...
aside from that, I feel it's better for us to be self-sufficient and
host our own files.

They're actually not that large (less than 100 MiB). The problem is
that Publican copies the audio files every time the Guide is published
in any language. We really only need one copy of the audio files. They
don't change between releases, and they're not translated.

POSSIBLE SOLUTION: Can I make a static directory in the web.git
repository, just for the Musicians' Guide's audio files? Then delete
all the current copies, and replace with a symlink?

I don't want to do first and ask questions later, just in case it
would interfere with Publican... that would be bad news so close to a
release!


Christopher.
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.12 (GNU/Linux)

iQEcBAEBAgAGBQJPvWMmAAoJEInCktGVqZ8V3GIH/2i9xOezXkOhjTNdbGDEeCHL
XvQMUv1ZZKYuuBxvsT0ym9HxghrFlH6Fw3MiYaabcN8IYiGTHCNYtT5E9QVI27rJ
8KTauLxOuMSa0Git+5Wa/Euoc0YPGIjLJgKfklNKJgGtw5GhCSmQwQFxbyG7QNTX
XPXIb9GG3lxRdE6qloOgPuIsyyZtWDVbYaO0JN4ikaFrmZDUfId3/9z6KEaXix1U
OlkPbwwn0ftyNcF2F7AlkYYNyaEFqRk0wt6n5SrNhAbZt7YPwlyC8+yuZB+3eeoC
BSxL2Y9g7lq4pobrvg82i9Ukj8VuhwY3xGK3jYet700K8aar9WI7C6SnHEEFX9I=
=rRJr
-----END PGP SIGNATURE-----

[Bug 823654] Wrong FreeIPA Guide for F16

2012-05-23T17:38:54

https://bugzilla.redhat.com/show_bug.cgi?id=823654

Deon Lackey <dlackey< at >redhat.com> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|NEW                         |MODIFIED

Re: Self-introduction

Ben Cotton — 2012-05-23T01:18:24

Alexander,

Welcome to Fedora Docs. We're about a week away from the release of
Fedora 17, so the group is wrapping up processes right now. Once the
Fedora 18 cycle begins, there will be plenty of opportunity for you to
jump in. In the meantime, look around and feel free to ask questions
here on the list or in the #fedora-docs room on irc.freenode.net. We
have weekly IRC meetings[0] at 1400 UTC on Mondays in #fedora-meeting.

We're looking forward to working with you!

[0] https://fedoraproject.org/wiki/Docs_Project_meetings

Self-introduction

Alexander Moore — 2012-05-22T19:23:56

I have written a lot of academic papers for my English classes. I covered a
variety of topics in those papers. I wrote a screen play based on the
"Killer Angles" novel by Michael Shaara. I wrote a descriptive paper on
series and parallel electrical circuitries and another descriptive paper on
the process of long division. I can go on about the history of Linux for
15-20 pages. I am two years into studying for a BS in Electrical
Engineering so my skill set is a beginner's level of c and c++ and I am
taking a java class over the summer. I am learning a lot about linux from
Fedora 16's documentation and I want to be able to keep it easy to learn
for users of future version. I am getting a "service unavailable" prompt
when I tried to sync my key with server specified.

Thank you.

[Bug 823654] Wrong FreeIPA Guide for F16

2012-05-21T19:37:10

https://bugzilla.redhat.com/show_bug.cgi?id=823654

Jaromir Hradilek <jhradile< at >redhat.com> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
           Assignee|nobody< at >fedoraproject.org    |dlackey< at >redhat.com

[Bug 823654] Wrong FreeIPA Guide for F16

2012-05-21T19:33:40

https://bugzilla.redhat.com/show_bug.cgi?id=823654

Chris Evich <cevich< at >redhat.com> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
           Keywords|                            |Documentation, EasyFix

[Bug 823654] New: Wrong FreeIPA Guide for F16

2012-05-21T19:32:00

https://bugzilla.redhat.com/show_bug.cgi?id=823654

            Bug ID: 823654
        QA Contact: docs< at >lists.fedoraproject.org
          Severity: medium
           Version: devel
          Priority: unspecified
                CC: eric< at >christensenplace.us, oglesbyzm< at >gmail.com,
                    stickster< at >gmail.com
          Assignee: nobody< at >fedoraproject.org
           Summary: Wrong FreeIPA Guide for F16
        Regression: ---
      Story Points: ---
    Classification: Fedora
                OS: Linux
          Reporter: cevich< at >redhat.com
              Type: Bug
     Documentation: ---
          Hardware: All
        Mount Type: ---
            Status: NEW
         Component: docs-requests
           Product: Fedora Documentation

Description of problem:
Fedora 16 uses FreeIPA 2.1.x, and the FreeIPA.org site correcty points it's doc
link at the 2,1,3 fedora documentation. However, the FreeIPA Guide listed under
Fedora 16 is for version 2.2.x which isn't available, though is slated for
Fedora 17 (I believe).

Version-Release number of selected component (if applicable):
Fedora 16 Documentation

How reproducible:
Very

Steps to Reproduce:
1. https://docs.fedoraproject.org/en-US/Fedora/16/html/FreeIPA_Guide/index.html
2. https://docs.fedoraproject.org/en-US/Fedora/15/html/FreeIPA_Guide/index.html

Actual results:
Fedora 16 users reference documentation for a much newer version of FreeIPA.

Expected results:
Fedora 16 users reference documentation relevant to availabe FreeIPA version.

Additional info:
I don't believe there is much different between FreeIPA 2.1.3 and 2.1.4 which
currently ships, it's probably fine to just keep referencing the 2.1.3 docs for
Fedora 16.

Tech Republic article about the LIve Docs

Ben Cotton — 2012-05-21T15:38:54

Please take a bow, jwulf:

http://tek.io/JiJIfv

Docs meeting summary -- 21 May 2012

Ben Cotton — 2012-05-21T15:12:21

Meeting summary
---------------
* Roll Call  (bcotton, 14:00:49)

* Follow up on last week's action items  (bcotton, 14:03:43)

* Schedule slip  (bcotton, 14:04:09)
  * GA is now May 29  (bcotton, 14:04:15)
  * the published RN and Docs schedules do not yet reflect this change
    (bcotton, 14:04:30)

* Release Notes  (bcotton, 14:07:01)
  * AGREED: Release Notes rpm changelogs will drop changes older than
    N-2  (bcotton, 14:16:11)

* Guide Status  (bcotton, 14:16:55)
  * Guide owners shoudl coordinate with pkovar and shaiton to clean up
    lang codes before GA  (bcotton, 14:18:37)
  * LINK:
    https://fedoraproject.org/wiki/Setting_up_a_document_with_Transifex#Step_5:_Map_Language_Codes
    (bcotton, 14:20:30)
  * LINK: https://bugzilla.redhat.com/show_bug.cgi?id=816765   (bcotton,
    14:21:19)

* Open Help Conference  (bcotton, 14:29:09)
  * LINK: http://openhelpconference.com   (bcotton, 14:29:15)
  * Open Help Conference is Aug 11-15 in Cincinnati, OH  (bcotton,
    14:29:21)

* FUDcon KL report  (bcotton, 14:42:18)
  * comments welcome on Live Docs screencast  (bcotton, 14:47:54)
  * LINK: www.fedorareloaded.com/index.html   (bcotton, 14:48:01)
  * LINK: http://kushal.fedorapeople.org/book/   (jwulf, 14:48:35)

* Open floor discussion  (bcotton, 14:55:23)

Meeting ended at 14:57:16 UTC.

Action Items
------------

Action Items, by person
-----------------------
* **UNASSIGNED**
  * (none)

People Present (lines said)
---------------------------
* bcotton (44)
* jwulf (39)
* jjmcd (35)
* pkovar (13)
* claneys (7)
* jsmith (6)
* randomuser (5)
* lnovich (4)
* zodbot (3)
* jwulf_ (2)
* Capesteve (2)
* Sparks (1)
* jhradilek (1)

Minutes:
http://meetbot.fedoraproject.org/fedora-meeting/2012-05-21/fedora_docs.2012-05-21-14.00.html
Minutes (text):
http://meetbot.fedoraproject.org/fedora-meeting/2012-05-21/fedora_docs.2012-05-21-14.00.txt
Log:
http://meetbot.fedoraproject.org/fedora-meeting/2012-05-21/fedora_docs.2012-05-21-14.00.log.html

Re: Merging transifex.net duplicated teams

Petr Kovar — 2012-05-21T15:06:18

Hi Christopher,

On Sat, 19 May 2012 18:31:27 -0400
"Christopher R. Antila" <crantila< at >fedoraproject.org> wrote:


When you look at the list of languages, you can see that many of them have
"(no team yet)". Basically, these are the duplicated lang codes that
should be merged into the correct ones.

For your guide, this should mean just merging Japanese, Dutch, Russian and
Ukrainian, and delete the rest of the lang codes as there are apparently no
translations into other languages available for your guide. 

As I said during today's meeting, feel free to ping me on #fedora-docs if
you need any help.

Cheers,

Fedora Docs Meeting Reminder

2012-05-21T04:59:01

This is an automated message to remind you that we will be meeting at 1400 UTC in #fedora-meeting. Unless we've previously agreed that we will not be meeting today.

Re: Merging transifex.net duplicated teams

Christopher R. Antila — 2012-05-19T22:31:27

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Hi:

I have attempted to do this for the Musicians' Guide for the Fedora 16
revision.[1] I will not publish this Guide in English for Fedora 17
because I haven't made many changes.

Could somebody please confirm that everything is correct?


Thanks,
Christopher.

[1] https://fedora.transifex.net/projects/p/fedora-musicians-guide/

On 05/18/2012 06:14 PM, Kévin Raymond wrote:
[2] http://lists.fedoraproject.org/pipermail/docs/2011-August/013611.html
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.12 (GNU/Linux)

iQEcBAEBAgAGBQJPuB86AAoJEInCktGVqZ8VWL8H/05uydT8O0w/di3gNb3KSu9Y
mdy5FjIA83yHG1wMtEMTK35eQ0vM8mYj3qh45cASoSOydAeq7tAZc/4LRVB+Nczf
VpQTThB2GsDKgijqbi5iLJfaKtOLPbSvu/xLWaWRhzk19FH1TmoM8a3Gny4gmi3u
Rx3++Dm48yVybqu5nHv+tTOgc/R8Mv5RVs97kft8lqXmGuEFjdjcMMGrJ+d/ebzv
M7tv90cJXoJHYeW6LLhiKbKHg1R/iZ5FP5mNYLIG3OEFOIUmiJOI5DcYjiok+EzS
F14rIZv4/8U7aRQQ7DKkmOXx3EypwoKNCu0sLQL7NjV/J9GUPz7Zw1xCPa3CZU0=
=5Xrl
-----END PGP SIGNATURE-----

Re: Self-Introduction: Jefferson Campos (Jeff - foguinhoperuca)

Joshua Wulf — 2012-05-19T13:34:10

Broken xml, plain text, anything goes. Someone else will fix it up later. 

Reading other, validating topics is a good way to learn Docbook xml. 

~ Kirtan is Life! ~
Sent from my Mobile Device

On 19/05/2012, at 9:02 PM, Joshua Wulf <jwulf< at >redhat.com> wrote:

Re: Self-Introduction: Jefferson Campos (Jeff - foguinhoperuca)

Joshua Wulf — 2012-05-19T13:02:01

G'day Jefferson, 

Bang on the FUDCon english book at www.fedorareloaded.com for instant gratification. 24 hours of live docs hacking left. 

- Josh

~ Kirtan is Life! ~
Sent from my Mobile Device

On 18/05/2012, at 9:37 PM, Ben Cotton <bcotton< at >fedoraproject.org> wrote:

Re: Merging transifex.net duplicated teams

Dimitris Glezos — 2012-05-18T22:40:20

Potentially useful:

Transifex Python library:
 https://github.com/transifex/transifex-python-library

-d


On Fri, May 18, 2012 at 3:14 PM, Kévin Raymond
<shaiton< at >fedoraproject.org> wrote: