Stepping down as Documentation Project Leader
by Eric Christensen
Some of you might have noticed, between sips of highly caffenated
beverages and furiously typing out all the great documentation that
this group provides, that I haven't been around that much lately.
Unfortunately just before Christmas I was given a new boss and new
responsibilities that changed my daily schedule. This, on top of
other changes to my daily schedule, has severely limited my ability to
provide a near-constant presence in the Fedora community. As much as
I hate to do this I feel that I must step down as the Documentation
Project Leader to allow someone with more cycles in their day to
continue the work.
This isn't a bad thing by any stretch of the imagination. It was
probably time for someone with new and different ideas to step up and
keep the project interesting. There have been a lot of changes under
my watch and I can hardly wait to see the changes that occur under the
next watch.
Back in November when we were entertaining the thought of holding
elections for my position, Zach Oglesby came to me and said that if I
needed to bail out of the position that he might be willing to take on
the responsibilities. Since then I've been talking with Zach and
today he agreed to take on the position. I'm very excited about him
accepting the position as he has been involved in every aspect of the
project for a while and I know he has some exciting ideas about moving
the project to the next level.
Thanks to everyone who helped me through the years (two?) that I've
held this position. Every contributor to this project has made it
successful and for that I am greatful to you all.
--Eric "Sparks"
13 years, 3 months
Publican: problem with toc.html
by Thomas Canniot
Hello,
I'm trying to publish my publican documentation with the following command:
publican build --publish --formats epub,html,html-single,pdf --langs
fr-FR --quiet --embedtoc
However, the html versions lack the toc.html file. I remember I had same
problem few months ago but I fail to solve the issue this time.
Can someone give a hand ?
I'm running the followings:
publican-fedora-2.0-0.fc14.noarch
publican-2.5-1.fc14.noarch
Many thanks,
Thomas
13 years, 3 months
Re: Fedora repo and publishing questions
by Eric Christensen
Paul,
I've put you in the docs group and the docs-writers group. This
should give you access to the repositories where the guide sources are
located.
--Eric
On Wed, Jan 26, 2011 at 09:29, Paul Kennedy <pkennedy(a)redhat.com> wrote:
> Hi Eric,
>
> My apologies for not replying earlier.
> Yes I do have a FAS account. My userid is kennepede.
>
> Paul
>
> On 12/16/2010 02:54 PM, Eric "Sparks" Christensen wrote:
>>
>> -----BEGIN PGP SIGNED MESSAGE-----
>> Hash: SHA256
>>
>> Hi Paul,
>>
>> Do you have a FAS account?
>>
>> - --Eric
>>
>>
>> On 12/16/2010 03:04 PM, Paul Kennedy wrote:
>>>
>>> Hi Eric,
>>>
>>> Following up on this.
>>>
>>> Paul
>>>
>>> Paul Kennedy wrote:
>>>>
>>>> Hi Eric,
>>>>
>>>> On the docs Task Table,
>>>> http://fedoraproject.org/wiki/Docs_Project_meetings#Task_table, I see
>>>> that the Security Guide has been migrated to f14. Any estimate on when
>>>> these will be be migrated?
>>>> - SELinux Managing Confined Services Guide
>>>> - SELinux User Guide
>>>>
>>>> Is that something I am supposed to do? Glad to do it, but I don't have
>>>> permission.
>>>>
>>>> Also, how do I go about pushing books to the fedora docs page?
>>>>
>>>> Thanks.
>>>>
>>>> Paul
>>>
>>>
>>
>> -----BEGIN PGP SIGNATURE-----
>> Version: GnuPG v1.4.11 (GNU/Linux)
>> Comment: Using GnuPG with Fedora - http://enigmail.mozdev.org/
>>
>> iF4EAREIAAYFAk0KfHUACgkQU03aaJDMNEXe6QD+OAV95chcdk9pUP2glzL1z5WH
>> Fj2gbd5vlI01/rxEiy4A/idGK2OP8r5vF82OrDUlariROWrddt6YpIruJjDmlFS1
>> =GFmC
>> -----END PGP SIGNATURE-----
>
>
>
>
13 years, 3 months
Re: Join the Docs group
by john＠ringusup.com
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1
resend again...I guess you don't need my help??
On Fri, 07 Jan 2011 12:17:43 +0800 john(a)ringusup.com wrote:
>resend
>
>On Wed, 29 Dec 2010 13:26:07 +0800 john(a)ringusup.com wrote:
>>Hi,
>>My name is John Owens, username "johnowenschina".
>>I have many years of experience in technical writing. My native
>>language is English, but I also speak, read and write Chinese.
>>
>>I would like to join the docs group.
>>
>>Best regards,
>>John Owens
>>
>
-----BEGIN PGP SIGNATURE-----
Note: This signature can be verified at https://www.hushtools.com/verify
Charset: UTF8
Version: Hush 3.0
wpwEAQMCAAYFAk05FrYACgkQR2aLzPeiEVnjRgQAoRfvG3wanCTep31+deJA2f5oq7Jr
jFNJWXKTWf2KbdoVZkT4rvT5VO+GA9mJeIiO5Fn1Uj7sGgGBNeWjFNft1DmKvHbOfPFh
SVYMpuW+TxT7NCJ/8tpBilZm7LzC0k5d3ptmShWXTIcxcTplhj5zoqzUxJ8mR/TnCXo2
Rynt3vc=
=kWnm
-----END PGP SIGNATURE-----
13 years, 3 months
Release Notes Beats Signup
by Zach Oglesby
Beats writers,
Now is the time to reclaim your beats, as of today I have added an *
next to all the writers from the F14 cycle. If you intend to continue
working that beat for Fedora 15 please go to the wiki and remove it.
For you new folks, there are tons of beats that don't yet have a
writer, and even if someone was working on a beat before doesn't mean
that you can't help. Take this opportunity to head over to the wiki
and sign up for a beat. It's a great way to help out and provides a
wonderful way to start getting involved more.
https://fedoraproject.org/wiki/Category:Documentation_beats
Zach Oglesby
GPG Key: 172E44AE
zoglesby on irc.freenode.net
https://fedoraproject.org/wiki/User:Zoglesby
13 years, 3 months
Re: Please tutor a crash course on Docs Project tools & workflow.
by Christopher Antila
Hello Jesus and everybody:
I encourage the creation of this "crash course" document. Even though
I've written a Guide and continue to update it periodically, I forget
how to use the Docs tools, and I certainly remember how intimidating it
was when I first started.
I also think that we need more people, as you say, to contribute "for
real to Fedora top-projects." The Guides collectively have many
opportunities for improvement. It's not that the Guide owners don't know
about these possible improvements, but that we don't have enough time to
make all of the possible optimizations between releases. Additional "for
real" contributors would be a significant advantage.
I'm not sure what you're asking, Jesus, but if you propose writing the
document yourself, then go ahead and get started! If you would like help
with specific tasks, like to make sure that a particular chapter is
correct, you can ask for help on this mailing list.
As a more general observation, I wonder if a stronger QA ("Quality
Assurance") process would help with this problem. I know that some
Guides have QA contacts, but for others Bugzilla simply gives this
mailing list, and some (like the Musicians' Guide) have no QA contact
whatsoever. Lack of an active QA process means that, if a contributor
makes a mistake, it won't be noticed until after release - and that's
understandably intimidating.
Christopher.
On Thu, 2011-01-20 at 12:00 +0000, docs-request(a)lists.fedoraproject.org
wrote:
> ...
>
> Message: 3
> Date: Thu, 20 Jan 2011 08:24:45 +0000 (UTC)
> From: Jes?s Franco <tezcatl(a)fedoraproject.org>
> Subject: Please tutor a crash course on Docs Project tools & workflow.
> To: docs(a)lists.fedoraproject.org
> Message-ID: <pan.2011.01.20.08.24.43(a)fedoraproject.org>
> Content-Type: text/plain; charset=UTF-8
>
> Hi Docs team.
>
> I've read on last meeting-minutes the action item about getting someone
> to leader the RelNotes writing. There is a lot of talk lately too about
> getting more people into contributing for real to Fedora top-projects.
>
> But i think this is not an area than marketing can manage just by making
> Fedora look friendly and open to all. I've read since i joined to Docs
> project a lot of people (just like me), willing to join, and no matter
> how much is said "don't worry, if you broke something we can fix it";
> it's simply overwhelming the idea of doing things bad since many times we
> don't know the way of doing things the right way.
>
> We need to learn how to make successfully what we'd like to. And no, there
> is no just matter of time or reading the bunch of pages under Docs
> category in the wiki. You know a lot of there is outdated and it becomes
> confusing when you read an updated page and kindly someone corrects and
> says: "It's outdated". A big WTF. (That's why i don't like mediawiki).
>
> This is happening because we are not the number of qualified people we
> would like to be. But we can.
>
> I'm working on a Draft for an introductory crash course to Docs Project,
> based on practical workshops to learn the basic of Publican, *git*, and
> the workflow preferred by the actual contributors.
>
> The goals of this course, would be:
>
> 0) Acquiring practical dominion of that tools, letting more people feel
> confident to join to the Docs project.
> 1) Recruiting more people to work into real tasks of Docs Project.
>
> Forgive my references to gaming.
>
> World 1
>
> ***Tutorial level. We need for first class...***
>
> * Make a schedule than effectively can let people to commit minor tasks
> with Publican/git, since first class.
> * A main tutor able to run at least one-and-a-half hour class on IRC,
> showing folks how to produce their first Doc with the minimum hassle.
> * People able to join to gobby writing of the first article of folks, to
> help tutor in fixing mistakes people will fail (something like paired
> programming driver-navigator).
>
> For folks unable to join to classroom session (and who can't finish the
> first world at first attempt).
>
> * More people helping the tutor in helping people (it can be via ML) to
> solve issues they (we) will face for sure at their first attempt.
> * Also, people answering questions the students will confront sharing
> their patches, and troubleshooting whatever error they will found.
>
> We can encourage students too, to helping each other via the ML, and
> getting into the thread just for fix minor mistakes.
>
> Following the games analogy:
> Level 1 would be actually writing with succes their first DocBook article.
> Level 2 uploading to a git repo.
> Level 3 taking another people article and suggesting changes via a patch.
> Level 4 applying the patch and adding collaborators. (er, optional?)
> Level 5 sharing their experience and figuring out what official guide
> they'd like to contribute.
>
> World 2.
>
> This time the challenge would be:
>
> * Choose a Docs top-document (Release Notes is my first candidate) to
> give people the chance to get into the real workflow of Docs project.
>
> We would combine again at least a synchronous session and the heavy load
> could be conducted through ML/bugzilla and work with repos/branches.
>
> I'm not so clear about that, so i'd like you really give feedback to:
>
> https://fedoraproject.org/wiki/Docs_Project/
> Course_for_New_Contributors#Second_week.2C_explore_into_the_jungle
>
> ==== Too much changes? Naah ====
>
> If you read carefully, we could load a bunch of people into ML and maybe
> messing into bugs and patches (and always has been said that's fine,
> since we always can clean the house, right?); Apart from the classroom
> meetings via IRC/Gobby, we wouldn't take much more work than today. Just
> compare that to the steps to join L10N and Ambassadors teams*.
>
> The real difference is we could arrange by some weeks people learning
> together and working with Guide owners and experimented people, hopefully
> giving them (us) a more solid scale to jump into Docs boat than sending
> them to find the bit into the mess of Docs category in the wiki.
>
> Also, everything of this experience should be stored as an updated
> reference for people unable to join at the first invitation. I'm
> confident than this would be something similar to writing code from
> scratch in a cleaner and fresh way, than trying to fix overbloated code
> with too many patches acumulated over the time.
>
> And i'm pretty sure all that experience could be summarized and rearranged
> as an actual course in a way people could follow the manual and becoming
> more able to join Docs project and getting their hands dirty.
>
> You can fire to me now ;)
>
>
> Best regards.
> --
> Jesus Franco
> Fedora Ambassador and Translator
> http://fedoraproject.org/wiki/User:Tezcatl
>
> P.S. I don't say translators and Ambassadors can't become better and rich
> higher levels in the quality of our contributions (I don't believe in
> number of strings translated just because Google seems easier than
> actually checking our translations). Just than those teams don't look so
> intimidating and it's lot of easier growing into them step by step.
>
>
13 years, 3 months
