#fedora-docs: Fedora Documentation FAD

Meeting summary

1. 1. https://fedoraproject.org/wiki/Docs_FAD_2014 (Sparks, 12:47:59)
   2. this session is being recorded on bluejeans and zodbot is keeping logs also (nb, 13:08:34)
   
   
2. introductions (nb, 13:17:21)
   1. randomuser (Pete) introduces himself, and his goals as our mighty leader (jsmith, 13:17:44)
   2. nb (Nick) introduces himself (jsmith, 13:17:58)
   3. Sparks (Eric) introduces himself (jsmith, 13:18:16)
   4. jsmith (Jared) introduces himself (nb, 13:18:40)
   5. jsmith wants to write more (nb, 13:19:09)
   6. pkovar introduces himself (jsmith, 13:19:34)
   7. jreznik claims not to do docs -- is just here for the food (jsmith, 13:19:50)
   8. jhradilek introduces himself (jsmith, 13:20:41)
   9. lnovich introduces herself (jsmith, 13:21:07)
   10. jsvarova introduces herself (jreznik, 13:22:16)
   11. jskarvad_mtg introduced himself - he's working on Power Management Guide (jreznik, 13:23:07)
   12. ACTION: jreznik to talk to WGs what they would like to see from docs team for products (jreznik, 13:27:17)
   13. Sparks talks about doing a better job of maintaining the wiki (jsmith, 13:31:24)
   14. noobs come from all souces - those who know Fedora, those who don't, those who know docbook, those who don't, those who know Linux, those who don't, those who have worked as a technical writer and those who haven't - we need to think about all those areas (lnovich, 13:34:42)
   15. Talking about new web publishing platform (jsmith, 13:35:13)
   16. New publishing platform doesn't authenticate based on FAS -- based on authorized_keys (jsmith, 13:35:41)
   17. jhradilek will push the new publishing instructions to the Documentation Guide later today. (jhradilek, 13:38:08)
   18. docs dev instance docs01.dev.cloud.fedoraproject.org (nb, 13:39:10)
   19. if you want access, ask nb to add your key to /root/.authorized_keys (nb, 13:39:21)
   20. correction: the dev instance uses authorized_keys, the production instance, docs-backend01.phx2.fedoraproject.org is based on sysadmin-docs membership (nb, 13:39:59)
   21. Highest Docs badge: https://badges.fedoraproject.org/badge/wordstorm-wordsmith-v (jsmith, 13:51:47)
   22. https://bugzilla.redhat.com/show_bug.cgi?id=1000862 (jhradilek, 13:55:27)
   23. patches vs docs (lnovich, 14:26:15)
   24. ACTION: Sparks to reach out to fedora design list re: videos {intro,ending, unification} and inline graphics for docs (randomuser, 14:46:49)
   25. https://fedoraproject.org/wiki/Videos (jreznik, 14:46:58)
   26. this call will be recorded for quality purposes :) (nb, 14:47:44)
   27. http://en.wikipedia.org/wiki/Massive_open_online_course (lnovich, 14:47:48)
   28. http://fedorapeople.org/groups/docs/ (nb, 14:49:20)
   29. AGREED: develop workflow for submission where 1) someone submits content 2) content is reviewed by experienced contributors 3) content is forwarded to {exisdevelop workflow for submission where 1) someone submits content 2) content is reviewed by experienced contributors 3) content is forwarded to {existing guide, new guide, cookbook}ting guide, new guide, cookbook} (randomuser, 15:24:37)
   30. ACTION: randomuser to open trac ticket for fedora cookbook (randomuser, 15:24:43)
   31. jsmith is the break coordinator, lol (nb, 15:36:33)
   
   
3. Trac instances for individual guides? (nb, 15:39:06)
   
4. Trac instances for individual guides? (jsmith, 15:39:07)
   1. ACTION: nb to review the trac pages for docs to see if there is stuff that needs to be kept then will nuke the old trac instancesd (nb, 15:43:07)
   2. Jargon Guide should be resurrected and is available at git://git.fedorahosted.org/git/docs/jargon-buster.git (Sparks, 15:51:09)
   3. https://github.com/eslobodo/AcroBot/ (jhradilek, 15:53:36)
   4. all guides are ~2.5GB (randomuser, 15:53:48)
   5. ACTION: lnovich to set up whenisgood poll and ask for participation (randomuser, 16:04:57)
   6. zoglesby is here! (nb, 16:10:44)
   7. http://opensource.com/life/13/11/book-sprint-doc-camp-2013 (pkovar, 16:12:34)
   8. http://google-opensource.blogspot.cz/2013/10/google-doc-camp-2013-wrapup.html (pkovar, 16:13:39)
   9. ACTION: nb to open ticket requesting badge for FAD participation (randomuser, 16:18:43)
   10. https://fedorahosted.org/fedora-badges/ticket/253 (nb, 16:24:48)
   11. that is the link for the badge request (nb, 16:25:10)
   12. http://conf.writethedocs.org/ (lnovich, 16:35:59)
   13. Sparks can share bluejeans access freely but there is a user count cap so you should request it (randomuser, 16:48:03)
   14. https://fedoraproject.org/wiki/Mentors#Documentation_.26_Translation (Sparks, 16:59:34)
   15. https://fedoraproject.org/wiki/Category:Docs_Project (randomuser, 17:41:55)
   16. https://fedoraproject.org/wiki/Gobby ? (randomuser, 17:43:27)
   17. https://fedoraproject.org/wiki/Category:Docs_Project_DE (randomuser, 17:53:28)
   18. https://fedoraproject.org/w/index.php?title=De_DE/DocsProject&action=history suggests it's unmaintained (pkovar, 17:54:44)
   19. https://fedoraproject.org/wiki/De_DE/Docs (Capesteve, 18:00:26)
   20. http://barparblog.files.wordpress.com/2012/08/the-thing_2.jpeg (pbokoc, 18:09:02)
   21. https://fedoraproject.org/wiki/Special:ListGroupRights (quaid, 18:18:05)
   22. https://fedoraproject.org/w/index.php?title=Special:ListUsers&group=sysop (quaid, 18:18:20)
   23. https://fedoraproject.org/wiki/Docs_Project_Style_Guide needs to go into Documentation Guide (randomuser, 18:21:48)
   24. ACTION: randomuser to https://fedoraproject.org/wiki/Docs_Project_Style_Guide add into Documentation Guide (randomuser, 18:22:27)
   
   
5. Publishing docs using Koji (Sparks, 18:54:21)
   1. https://fedoraproject.org/wiki/Publishing_a_document_with_Publican#Publishing_using_Koji (Sparks, 18:54:27)
   2. ACTION: lnovich to explain SEO techniques later (randomuser, 19:28:51)

Action items

1. jreznik to talk to WGs what they would like to see from docs team for products
2. Sparks to reach out to fedora design list re: videos {intro,ending, unification} and inline graphics for docs
3. randomuser to open trac ticket for fedora cookbook
4. nb to review the trac pages for docs to see if there is stuff that needs to be kept then will nuke the old trac instancesd
5. lnovich to set up whenisgood poll and ask for participation
6. nb to open ticket requesting badge for FAD participation
7. randomuser to https://fedoraproject.org/wiki/Docs_Project_Style_Guide add into Documentation Guide
8. lnovich to explain SEO techniques later

Action items, by person

1. jreznik
   1. jreznik to talk to WGs what they would like to see from docs team for products
2. lnovich
   1. lnovich to set up whenisgood poll and ask for participation
   2. lnovich to explain SEO techniques later
3. nb
   1. nb to review the trac pages for docs to see if there is stuff that needs to be kept then will nuke the old trac instancesd
   2. nb to open ticket requesting badge for FAD participation
4. randomuser
   1. randomuser to open trac ticket for fedora cookbook
   2. randomuser to https://fedoraproject.org/wiki/Docs_Project_Style_Guide add into Documentation Guide
5. Sparks
   1. Sparks to reach out to fedora design list re: videos {intro,ending, unification} and inline graphics for docs

People present (lines said)

1. nb (96)
2. randomuser (63)
3. jhradilek (47)
4. lnovich (45)
5. jsmith (33)
6. Sparks (31)
7. pkovar (24)
8. jreznik (22)
9. zodbot (14)
10. quaid (13)
11. zoglesby (12)
12. Capesteve (9)
13. pbokoc (8)
14. pandaconstantin (5)
15. jskarvad (2)
16. yruseva (1)