From Fedora Project Wiki

 
(23 intermediate revisions by 3 users not shown)
Line 1: Line 1:
I am just getting started with [http://fedoraproject.org/wiki/DocsProject Fedora Docs].
<!--
{{Infobox user
|REAL-NAME=Susan Lauber
|location=
|homepage=http://travelingtrainer.laubersolutions.com/
|fas-name=laubersm
|email=laubersm@fedoraproject.org
}}
-->


=Current Projects=
{{Template:Userpage/Infobox2
As I get started and learn the tools, I hope to help document the [http://fedoraproject.org/wiki/DocsProject/WorkFlow processes/workflow] so it is easier for other people to also [http://fedoraproject.org/wiki/DocsProject/Join get started].
|REAL-NAME=Susan Lauber
|image=Hackergotchi-Laubersm.png
|birthday=
|birthplace=  
|HOME=http://travelingtrainer.laubersolutions.com/
|FAS-NAME=laubersm
|IRC=laubersm
|irc-channels=#fedora-docs, #fedora-ambassadors (and others)
|pmail=
|gpg=4175B87B
|homepage=http://www.laubersolutions.com
|jabber=
}}


Over the holiday and through the [https://fedoraproject.org/wiki/Docs_Project_Holiday_Virtual_Hackfest hackfest] and [http://fedoraproject.org/wiki/FUDCon/FUDConF11 FUDcon], I will add tips and reminders here.


===communication===
==Current Projects==
*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===
I am a member of the [[Ambassadors]] group. When I looked at the list of Ambassadors way back when, I was surprised at how few were from North Carolina. I also found that I could answer yes to all three of the questions raised that were then on the [[Ambassadors/Join | join]] page (the processes have changed with time and growth). As an Linux instructor in my $dayjob I already did (and still do) many of the other tasks listed under how to be an active ambassador.
*style guide
*naming guide
*[https://fedoraproject.org/wiki/Wiki_gardening 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)]
*[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]
**[http://fedoraproject.org/wiki/DocsProject/DocBook Fedora Docs intro and links]
*[http://www.w3schools.com/xml/default.asp XML]


*soon: [https://fedoraproject.org/wiki/CMS_solution_for_Fedora_Project_websites CMS]
Even though I had been working with open source for many years, my first contribution to any community project was as general contributor to the [[DocsProject | Docs Project]]. This includes wiki gardening and assisting with the various guides such as the Users Guide and the Installation Guide which are updated each release. I learned about Docbook and Publican through this project and still use those skills in my $dayjob today. I would like to do more with the project in general and have a particular interest in assisting with the security related guides.


=FUDCON=
I am still interested in assisting the [[Infrastructure]] team and am on several of the mailing lists from when I joined several years ago. It is an excellent way to watch a large project make use of cutting edge technology and if I could just dedicate some more time to it, I could learn so much about products I am aware of, interested in, but have not had a chance to really implement. Just lurking on the mailing list prepared me for $dayjob adventures with Puppet and Ansible.
==links==
*https://fedoraproject.org/wiki/Docs_Project_tasks_during_FUDConF11
*http://fedoraproject.org/wiki/User:Ianweller/FUDConF11_State_of_the_Wiki_presentation
*https://fedoraproject.org/wiki/Your_Docs_Project_BarCamp_session_FUDConF11


*[[Category:FUDConF11 BarCamp sessions]]
I do not post to [http://planet.fedoraproject.org/ Fedora Planet] often enough and I am a newbie player at Badges and slowly collecting a variety:
{{ #fedorabadges: laubersm }}


*see a list of existing categories?
Outside of Fedora, Red Hat, and CentOS, and mostly in my $dayjob, I am involved with Apache Hadoop and several related ecosystem products. I also continue to my InfoSec activities merging security topics and open source whenever possible. I was active in some of the early days of OpenStack for both $dayjob and also at an GHC opensource days helping with documentation but spend more time these days with OpenShift and its upstream components. I hold certifications from Red Hat, Cloudera, and ISC2.
**special pages: https://fedoraproject.org/wiki/Special:SpecialPages
**https://fedoraproject.org/wiki/Special:Categories


*We want only a handful of top level categories:
== Contact ==
**http://fedoraproject.org/wiki/Special:UncategorizedCategories
<!-- 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. -->
<!-- [[Image:|right]] -->


* wikibot - is available (pywikibot) move pages, rename pages, remove double redirects,
<!-- [[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>.''']] -->
**https://fedoraproject.org/wiki/Wikibot_page_restructuring


* wikipedia style manual for more organization tips
<!-- [[Image:Hackergotchi-Laubersm.png|right]] -->


==QandA==
* '''Email''': laubersm AT fedoraproject dOt org
*Question: why cms instead of wiki?
* '''IRC''': laubersm on [http://freenode.net freenode] (mostly in #fedora-docs but also others)
** really it is not instead of - it is in addition to...
* '''Fedora Account System''': Laubersm ([https://badges.fedoraproject.org/user/laubersm Badges])
** wiki - quick collaboration, easily updated, frequently changing, end-users
* '''NEW GPG key''':
** 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.
<pre>
 
pub  4096R/4175B87B 2017-09-22 [expires: 2022-09-21]
==wiki Pagenaming/style tip==
      Key fingerprint = 35BA D9A9 3D26 C1DC CB05  BC59 F62E 00C1 4175 B87B
*page can only be in one namespace but can have multi categories.
uid                  Susan Lauber (Lauber System Solutions, Inc.) <sml@laubersolutions.com>
*level1 headers are deprecated and bad bad bad - (page name can have spaces so name your page the level1 headers)
sub  4096R/6CC6B6C0 2017-09-22 [expires: 2022-09-21]
*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.
</pre>
*put category at the bottom of page
* '''OLD GPG key''':
*can we find pages with a l1 header - and rename page using l1 header and remove l1 header
<pre>
*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.
pub  1024D/BFA10974 2005-12-13
 
      Key fingerprint = 15AC F794 A3D9 64D1 D9CE  4C26 EFC3 11C2 BFA1 0974
==Docbook presentation notes==
uid                  Susan Lauber <sml@laubersolutions.com>
Note: This is just what is new to me and I have used docbook before so ...
uid                  Lauber System Solutions, Inc. <lauber@ties.org>
so it is not all notes from the talk . See above for link to docbook documentation.
uid                  Susan Lauber <susan@ties.org>
 
uid                  Susan Lauber <laubersm@gmail.com>
*do not forget the declaration for xml DOCTYPE docbook.dtd at the beginning.
uid                  Susan Lauber (Fedora Project) <laubersm@fedoraproject.org>
** it may be used by tools (validators) or created by tools (Publican)
sub  2048g/6425FFD3 2005-12-13
** it is used for validation
</pre>
** we are using V4.4
** cut and paste - but note book vs article
 
*first element must match declaration (book vs article)
 
*Xincludes
** helps with repurposing content
** ie each chapter is in its own file. then the book/article just includes with appropriate chapters.
** can include any type - chapter, para, ...
 
*ENTITY
** define the entity  !ENTITY DISTRO "The Susan spin of Fedora"
*** inline or through a reference to a separate file (.ent file)
** publican will auto include (and use fedora-branding for this and more)
** use as &DISTRO; in content
 
*tools tools (for any xml not just docbook)
** xmlint - does it follow the dtd
** xsltproc - transforms to other types like pdf or html
** xmltidy
 
*toolchains
** lots of older one and custom one.
** Fedora now including and using Publican
 
* file.xml -> xsltproc -> file.fo -> fop -> file.pdf
** xsltproc read in style sheet
** fo is about layout
 
*publican
** can create template
<pre>create_book --brand=fedora --type=article --name=article2 </pre>
 
==git for dummies by dummies==
 
<pre> yum install git-all</pre>
 
<code>git-config</code> program is deprecated
 
<pre>git config --global user.name 'Susan Lauber'</pre>
 
*writes out to .gitconfig
*I missed Paul's list of other global settings as a minimum


Get a copy of a repo
==Past Projects==
*make a directory for your copy then clone the repo
<pre>git clone ssh://git.fedorahosts.org/git/docs/install-guide</pre>


*uses the .git subdir to hold objects, logs, info, branches, refs, and more
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/FUDConF11|FUDcon]], I added tips and reminders. These are now located at
* .git/hooks include scripts
* [[User:Laubersm/Getting started with the docs project notes]]
* .git/branches are low overhead, easy, very useful
* [[User:Laubersm/Notes and links from FUDCON F11]]
* .git/HEAD points to tip of history


..missing stuff.. while checking gpg fingerprints...
<!--
wiki pages that I would like to seen created, expanded, or generally cleaned up but haven't gotten to yet
* Managing documentation guides with git (cloning, git vs ssh, global config, local config, branches, add, commit, push, diff, revert)
* Category:Wiki Mainatainers with some of Ian's templates, how to patrol, tips for the cleanup process, using Special pages, etc.
* Release Notes process - including [[Docs decisions for F12]]
-->


useful git commands:
I have "herded cats" for updates to the User Guide and was the lead for that document for a couple of releases.
*status
*diff  and diff --cached  (from the "mob teaches Paul" series)
*add
*commit and commit -a


during commit edit msg
When I had more time to dedicate to the wiki each week, I was the Docs Project contact person for the Packaging Guide and related documentation.  Tasks were listed in [[Docs_tasks_for_Packaging_Guide_and_related_materials]].  The first step was wiki cleanup.  Then looking into using the CMS for better workflow and access control with the actual Packaging Guide documentation. As the testing of the CMS started, I also applied to the [[Infrastructure]] team.  Toshio was nice enough to ask and to sponsor me so that I can at least be involved in the testing of the CMS.  I am interested in being on the team but concerned that I do not have the time to contribute as much as is necessary.  Time will tell (pun intended).
* first line,keep it short (summery and email subject)
* skip a line then type a longer log (details and email body)


git commit is just committing to local repo
==Self Introduction - a.k.a "How I got here"==
git push actually pushes up
<!--
 
<code>git-format-patch</code>  to generate a patch file
 
reverting: <code>git reset</code>
 
more recommended documentation: [[http://book.git-scm.com/ Git Community Book]]
 
=Self Introduction=
Greetings,
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 had been meaning to get more involved with fedoraproject for a while before I finally made the commitment. For all that I use and recommend opensource, this is the first project I actually joined (better late then never I guess).


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.  
I am interested in all things related to learning and teaching - documentation, planning, consulting, corporate training, university settings, and youngsters too.


The Red Hat Academy project involved working with DocBook.
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, contributing to online course content and videos, updating existing courses, and providing content for the first release and later updates of Red Hat Academy materials (with docbook). I also teach courses related to other Linux distributions and general computing security topics.  In addition to teaching formal classes, I also do some consulting and really enjoy the short assignments that are often mostly an informal skill transfer.
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 started with the docs project because it seemed that I had most of the skills needed, felt confident that I could quickly pick up the remaining skills, and it seemed to be the most flexible on time commitments.  I had taught and used cvs and seen subversion so I quickly figuring out the basics of using git. I was new to wiki syntax and irc etiquette but I after poking around and reading some of the intro and FAQ docs I quickly felt comfortable with those tools as well.  


I am interested in all things related to learning and teaching - documentation, corporate training, university settings, and youngsters too.
I am interested in learning new software through the infrastructure team and expanding my rpm packaging skills.
 
I am also lurking on the OLPC list and as a longer term goal, I would like to learn more about packaging.


-Susan
-Susan
<pre>
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
</pre>


--  
--  
Susan Lauber, (RHCX, RHCA, RHCSS)<br>
Susan Lauber, (RHCX, RHCSS, RHCA, RHCVA, CISSP)<br>
Lauber System Solutions, Inc. <br>
Lauber System Solutions, Inc. <br>
http://www.laubersolutions.com <br>
http://www.laubersolutions.com <br>
gpg: 15AC F794 A3D9 64D1 D9CE  4C26 EFC3 11C2 BFA1 0974
gpg: 15AC F794 A3D9 64D1 D9CE  4C26 EFC3 11C2 BFA1 0974
-->
My [https://www.redhat.com/archives/fedora-docs-list/2008-November/msg00000.html self introduction (2008)] to the docs project list.
My [https://www.redhat.com/archives/fedora-devel-list/2009-January/msg01545.html introduction (2009)] to the packaging and devel lists concerning wiki cleanup.
[[Category:Ambassadors from the USA]]

Latest revision as of 19:43, 14 October 2017


Susan Lauber
Susan Lauber
Susan Lauber
Fedora Information
FAS name: laubersm
Fedora email: laubersm@fedoraproject.org
IRC nick: laubersm
IRC channels: #fedora-docs, #fedora-ambassadors (and others)
Fedorapeople page: https://laubersm.fedorapeople.org
Badges (48)
Riddle Me This Bloggin' it! (Planet I) Involvement Ambassador Mugshot Paranoid Panda Secretary General Speak Up! Embryo Bloggin' it! (Planet III) Bloggin' it! (Planet IV) Bloggin' it! (Planet II) Junior Badger (Badger I) Tadpole Egg Tadpole with Legs Baby Badger Associate Badger (Badger 1.5) Nuancier F23 Bob Loblaw (Planet V) Froglet Red Hat Summit 2016 I Voted: Fedora 31 iot-name-game Red Hat Summit 2021 Nest with Fedora 2022 Attendee Nuancier 21 Origin Nuancier F26 Red Hat Summit 2017 Community Messenger I Fedora & CentOS Social @ Summit 2020 Lets have a party Fedora 35 IoT Working Group Member Don't Call it a Comeback Crypto Badger Fedora at RH Summit, 2015 OSCON 2015 Attendee Let Me Introduce Myself Macaron (Cookie I) Junior Editor Adult Frog Nuancier F30 I Voted: Fedora 32 Lets have a party Fedora 34 Nest Attendee 2021 Museum Visitor Lets have a party Fedora 36
 


Current Projects

I am a member of the Ambassadors group. When I looked at the list of Ambassadors way back when, I was surprised at how few were from North Carolina. I also found that I could answer yes to all three of the questions raised that were then on the join page (the processes have changed with time and growth). As an Linux instructor in my $dayjob I already did (and still do) many of the other tasks listed under how to be an active ambassador.

Even though I had been working with open source for many years, my first contribution to any community project was as general contributor to the Docs Project. This includes wiki gardening and assisting with the various guides such as the Users Guide and the Installation Guide which are updated each release. I learned about Docbook and Publican through this project and still use those skills in my $dayjob today. I would like to do more with the project in general and have a particular interest in assisting with the security related guides.

I am still interested in assisting the Infrastructure team and am on several of the mailing lists from when I joined several years ago. It is an excellent way to watch a large project make use of cutting edge technology and if I could just dedicate some more time to it, I could learn so much about products I am aware of, interested in, but have not had a chance to really implement. Just lurking on the mailing list prepared me for $dayjob adventures with Puppet and Ansible.

I do not post to Fedora Planet often enough and I am a newbie player at Badges and slowly collecting a variety: Riddle Me This Bloggin' it! (Planet I) Involvement Ambassador Mugshot Paranoid Panda Secretary General Speak Up! Embryo Bloggin' it! (Planet III) Bloggin' it! (Planet IV) Bloggin' it! (Planet II) Junior Badger (Badger I) Tadpole Egg Tadpole with Legs Baby Badger Don't Call it a Comeback Crypto Badger Macaron (Cookie I) Red Hat Summit 2016 Nuancier F26 Junior Editor Adult Frog Nuancier F30 Community Messenger I I Voted: Fedora 32 Nest Attendee 2021 Museum Visitor Origin Froglet Red Hat Summit 2017 I Voted: Fedora 31 Fedora & CentOS Social @ Summit 2020 Lets have a party Fedora 34 Red Hat Summit 2021 Lets have a party Fedora 35 Nuancier 21 Fedora at RH Summit, 2015 OSCON 2015 Attendee Let Me Introduce Myself Associate Badger (Badger 1.5) Nuancier F23 Bob Loblaw (Planet V) iot-name-game Lets have a party Fedora 36 Nest with Fedora 2022 Attendee IoT Working Group Member

Outside of Fedora, Red Hat, and CentOS, and mostly in my $dayjob, I am involved with Apache Hadoop and several related ecosystem products. I also continue to my InfoSec activities merging security topics and open source whenever possible. I was active in some of the early days of OpenStack for both $dayjob and also at an GHC opensource days helping with documentation but spend more time these days with OpenShift and its upstream components. I hold certifications from Red Hat, Cloudera, and ISC2.

Contact

  • Email: laubersm AT fedoraproject dOt org
  • IRC: laubersm on freenode (mostly in #fedora-docs but also others)
  • Fedora Account System: Laubersm (Badges)
  • NEW GPG key:
pub   4096R/4175B87B 2017-09-22 [expires: 2022-09-21]
      Key fingerprint = 35BA D9A9 3D26 C1DC CB05  BC59 F62E 00C1 4175 B87B
uid                  Susan Lauber (Lauber System Solutions, Inc.) <sml@laubersolutions.com>
sub   4096R/6CC6B6C0 2017-09-22 [expires: 2022-09-21]
  • OLD GPG key:
pub   1024D/BFA10974 2005-12-13
      Key fingerprint = 15AC F794 A3D9 64D1 D9CE  4C26 EFC3 11C2 BFA1 0974
uid                  Susan Lauber <sml@laubersolutions.com>
uid                  Lauber System Solutions, Inc. <lauber@ties.org>
uid                  Susan Lauber <susan@ties.org>
uid                  Susan Lauber <laubersm@gmail.com>
uid                  Susan Lauber (Fedora Project) <laubersm@fedoraproject.org>
sub   2048g/6425FFD3 2005-12-13

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 added tips and reminders. These are now located at


I have "herded cats" for updates to the User Guide and was the lead for that document for a couple of releases.

When I had more time to dedicate to the wiki each week, I was the Docs Project contact person for the Packaging Guide and related documentation. Tasks were listed in Docs_tasks_for_Packaging_Guide_and_related_materials. The first step was wiki cleanup. Then looking into using the CMS for better workflow and access control with the actual Packaging Guide documentation. As the testing of the CMS started, I also applied to the Infrastructure team. Toshio was nice enough to ask and to sponsor me so that I can at least be involved in the testing of the CMS. I am interested in being on the team but concerned that I do not have the time to contribute as much as is necessary. Time will tell (pun intended).

Self Introduction - a.k.a "How I got here"

My self introduction (2008) to the docs project list. My introduction (2009) to the packaging and devel lists concerning wiki cleanup.