From Fedora Project Wiki

m (setup for major rework)
(reworked user page - wow I have past projects!)
Line 1: Line 1:
I am just getting started with [http://fedoraproject.org/wiki/DocsProject Fedora Docs].
= Your Name and Surname =
<!-- Use code like this to put your hackergotchi or whatnot on the right side of the page. -->
<!-- Use code like this to put your hackergotchi or whatnot on the right side of the page. -->
<!-- Upload the file and edit the code below to match. -->
<!-- Upload the file and edit the code below to match. -->
<!-- [[Image:|right]] -->
<!-- [[Image:|right]] -->
[[Image:userpicexample.png|thumbnail|right|frame|'''Don't forget to replace your_name.png with actual file name when uploading. Then edit this page and put the uploaded file name in place of <nowiki>Image:username.png</nowiki>.''']]


 
<!-- [[Image:userpicexample.png|thumbnail|right|frame|'''Don't forget to replace your_name.png with actual file name when uploading. Then edit this page and put the uploaded file name in place of <nowiki>Image:username.png</nowiki>.''']] -->
Some words about you.


== Contact ==
== Contact ==


* '''Email''': mailto:you@example.com
* '''Email''': laubersm@fedoraproject.org
* '''IRC''': Your freenode IRC name and channels you hang out (eg. #fedora-docs, etc.)
* '''IRC''': laubersm (mostly in #fedora-docs)
* '''GPG key''': Your key ID and/or signature
* '''Fedora Account''': Laubersm [[Infrastructure/AccountSystem|Fedora Account System]]
* '''Fedora Account''': Your username on the [[Infrastructure/AccountSystem|Fedora Account System]]
* '''GPG key''':  
 
<pre>
== Activities within Fedora ==
pub  1024D/BFA10974 2005-12-13
 
      Key fingerprint = 15AC F794 A3D9 64D1 D9CE  4C26 EFC3 11C2 BFA1 0974
* Some words about your involvement in Fedora, your plans, ideas, etc.
uid                  Lauber System Solutions, Inc. <lauber@ties.org>
* For example, if you are into translations, the languages you are working on; if you are into docs, the docs you are interested in, etc.
uid                  Susan Lauber <susan@ties.org>
 
uid                  Susan Lauber <laubersm@gmail.com>
[[Category:Homepage]]
uid                  Susan Lauber <sml@laubersolutions.com>
 
uid                  Susan Lauber (Fedora Project) <laubersm@fedoraproject.org>
=Current Projects=
sub   2048g/6425FFD3 2005-12-13
 
</pre>
=Past Projects=
As I get started and learn the tools, I hope to help document the [[DocsProject/WorkFlow]] so it is easier for other people to also [[Join]].
 
Over the holiday and through the [[Docs Project Holiday Virtual Hackfest]] and [http://fedoraproject.org/wiki/FUDCon/FUDConF11 FUDcon], I will add tips and reminders here.
 
===communication===
*a FAS account [https://admin.fedoraproject.org/accounts/user/new create an account]
*mailing lists - [https://listman.redhat.com/mailman/listinfo/fedora-docs-list fedora-docs-list] and [https://admin.fedoraproject.org/mailman/listinfo/fedora-wiki fedora-wiki-list]
*ssh keys, gpg keys
*irc (client and nickname)- [https://fedoraproject.org/wiki/Communicate/IRCHowTo Fedora IRCHowTO]
*weekly irc meeting [https://fedoraproject.org/wiki/DocsProject/SteeringCommittee/Meetings agenda]
*[https://fedoraproject.org/wiki/Communicate/GobbyHowTo gobby] collaboration tool
 
===guides===
*style guide
*naming guide
*[[Wiki gardening]]
===packages/technologies===
*[http://git.or.cz/ git] an open source version control system in the category of distributed source code management tools
**[http://git.fedoraproject.org/git/ Fedora's git projects]
**[http://www.kernel.org/pub/software/scm/git/docs/gittutorial.html gittuorial(7)]
**[[Git talk for and by dummies at FUDCon F11]] presenter notes
**[[User:laubersm/Git talk at FUDCon F11]] my notes from git talk fudcon11
**[[Git Talk FUDCon10]] a page from [[:Category:Pages that need love]]
    
 
*[https://fedorahosted.org/publican/ Publican] and the Fedora branding: <pre>su -c "yum install publican publican-fedora"</pre>
**[http://jfearn.fedorapeople.org/Publican/index.html User's Guide]
**[http://iquaid.org/2008/03/30/reviewing-toolchains-publican-and-cvsdocs/ Some reasons why (iquaid.org)]
 
 
*[http://www.docbook.org/ DocBook]
**[[DocsProject/DocBook]] has notes and more links for how we use DocBook.
**[[DocBook BarCamp session FUDConF11]] - my notes (thankfully cleanup by someone) plus the presentation slides
 
 
*[http://www.w3schools.com/xml/default.asp XML]
 
*soon: [[CMS solution for Fedora Project websites]]
 
==FUDCON==
==links==
*[[Docs_Project_tasks_during_FUDConF11]]
*[[:User:Ianweller/FUDConF11_State_of_the_Wiki_presentation]]
*[[Your_Docs_Project_BarCamp_session_FUDConF11]]
 
*See writeup of BarCamp sessions - some by presenters, some by attendees: [[:Category:FUDConF11_BarCamp_sessions]]
 
*see a list of existing categories: [[:Special:Categories]] and special pages: [[:Special:SpecialPages]]


*In the end we want only a handful of top level categories: [[:Special:UncategorizedCategories]]


* wikibot - is available (pywikibot) move pages, rename pages, remove double redirects, [[Wikibot_page_restructuring]]
==Current Projects==


* wikipedia style manual for more organization tips
I am the Docs Project contact person for the Packaging Guide and related documentation.  Tasks are listed in [[Docs_tasks_for_Packaging_Guide_and_related_materials]].  The first step is wiki cleanup.  Then looking into using the CMS for better workflow and access control with the actual Packaging Guide documentation.


==QandA==
*Question: why cms instead of wiki?
** really it is not instead of - it is in addition to...
** wiki - quick collaboration, easily updated, frequently changing, end-users
** cms - more static content that must be in xml (docs) and transated and more restricted content like packaging and legal and logos. and lifecycle tracking - to end of life version specific content.


==wiki Pagenaming/style tip==
==Past Projects==
*page can only be in one namespace but can have multi categories.
*level1 headers are deprecated and bad bad bad - (page name can have spaces so name your page the level1 headers)
*first thing should not be section header so you get an intro para THEN the table of contents in intro mention that title (in bold). From mediawiki style guide.
*put category at the bottom of page
*can we find pages with a l1 header - and rename page using l1 header and remove l1 header
*look at [[https://fedoraproject.org/wiki/Category:Fonts fonts]] as how category page can have it's own content. uses templates to then list all pages within that category.


As I was getting started, I took notes in hopes of helping the [[DocsProject/WorkFlow]] so it is easier for other people to also [[Join]]. Over the 2008 Christmas holiday and through the [[Docs Project Holiday Virtual Hackfest]] and [http://fedoraproject.org/wiki/FUDCon/FUDConF11 FUDcon], I addedtips and reminders.  These are now located at
* [[User:Laubersm/Getting started with the docs project notes]]
* [[User:Laubersm/Notes and links from FUDCON F11]]




=Self Introduction=
==Self Introduction==
Greetings,
Greetings,



Revision as of 18:49, 5 February 2009


Contact

  • Email: laubersm@fedoraproject.org
  • IRC: laubersm (mostly in #fedora-docs)
  • Fedora Account: Laubersm Fedora Account System
  • GPG key:
pub   1024D/BFA10974 2005-12-13
      Key fingerprint = 15AC F794 A3D9 64D1 D9CE  4C26 EFC3 11C2 BFA1 0974
uid                  Lauber System Solutions, Inc. <lauber@ties.org>
uid                  Susan Lauber <susan@ties.org>
uid                  Susan Lauber <laubersm@gmail.com>
uid                  Susan Lauber <sml@laubersolutions.com>
uid                  Susan Lauber (Fedora Project) <laubersm@fedoraproject.org>
sub   2048g/6425FFD3 2005-12-13


Current Projects

I am the Docs Project contact person for the Packaging Guide and related documentation. Tasks are listed in Docs_tasks_for_Packaging_Guide_and_related_materials. The first step is wiki cleanup. Then looking into using the CMS for better workflow and access control with the actual Packaging Guide documentation.


Past Projects

As I was getting started, I took notes in hopes of helping the DocsProject/WorkFlow so it is easier for other people to also Join. Over the 2008 Christmas holiday and through the Docs Project Holiday Virtual Hackfest and FUDcon, I addedtips and reminders. These are now located at


Self Introduction

Greetings,

I have been meaning to get more involved with fedoraproject for a while and I have been lurking here on the docs list for a few weeks now. I was struggling a little to figure out how this project worked but then I rescued about 50 messages from my spam folder and it is now starting to make more sense :)

I have been a contract instructor for Red Hat since 2000 and involved in network operating system support and training since 1992 (and *nix user even longer). I have contributed to Red Hat course materials including general bug reports, testing updated labs, helping to update the online training from RHEL3 to RHEL4, and providing content for the first release of Red Hat Academy materials.

The Red Hat Academy project involved working with DocBook. I have taught and used cvs, seen subversion, and am sure I can figure out git relatively quickly. I am not as versed in wiki and irc etiquette and usage but I have been poking around and reading some of the intro and FAQ docs and of course I have had plenty of experience with mailing lists and AIM.

And for all that I use and recommend opensource, this is the first project I have actually joined (better late then never I guess).

I am interested in all things related to learning and teaching - documentation, corporate training, university settings, and youngsters too.

I am also lurking on the OLPC list and as a longer term goal, I would like to learn more about packaging.

-Susan

pub   1024D/BFA10974 2005-12-13
      Key fingerprint = 15AC F794 A3D9 64D1 D9CE  4C26 EFC3 11C2 BFA1 0974
uid                  Lauber System Solutions, Inc. <lauber@ties.org>
uid                  Susan Lauber <susan@ties.org>
uid                  Susan Lauber <laubersm@gmail.com>
uid                  Susan Lauber <sml@laubersolutions.com>
sub   2048g/6425FFD3 2005-12-13

-- Susan Lauber, (RHCX, RHCA, RHCSS)
Lauber System Solutions, Inc.
http://www.laubersolutions.com
gpg: 15AC F794 A3D9 64D1 D9CE 4C26 EFC3 11C2 BFA1 0974