docs October 2013

docs@lists.fedoraproject.org

10 participants
21 discussions

#5214: Setup koji tags and repo for Docs
by Fedora Release Engineering 22 Jan '14

22 Jan '14

#5214: Setup koji tags and repo for Docs -----------------------------+------------------------ Reporter: crantila | Owner: rel-eng@… Type: task | Status: new Milestone: Fedora 18 Alpha | Component: koji Keywords: docs | Blocked By: Blocking: | -----------------------------+------------------------ Posted here as per [https://fedorahosted.org/fedora- infrastructure/ticket/3320] '''phenomenon''' To support simpler and more robust updates to docs.fp.o, need to setup koji to handle a new tag and repo for Docs. '''implementation recommendation''' <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! -- Ticket URL: <https://fedorahosted.org/rel-eng/ticket/5214> Fedora Release Engineering <http://fedorahosted.org/rel-eng> Release Engineering for the Fedora Project

1 15

Fedora Docs Meeting Reminder, 28OCT2013 1400UTC
by Pete Travis 28 Oct '13

28 Oct '13

Greetings, this is your weekly email reminder to join the upcoming meeting of the Fedora Documentation Project! The meeting takes place in #fedora-meeting on freenode at 1400UTC. -- -- Pete Travis - Fedora Docs Project Leader - 'randomuser' on freenode - immanetize(a)fedoraproject.org

1 0

Self-Introduction: Edith Rivero
by Edith Rivero Tupac 24 Oct '13

24 Oct '13

Name: Edith Rivero --- Time Zone: UTC-5 --- Country: Peru Hello to everyone on this project. First of all, I hope you can understand my English (I have a personal promise of training it every day). My name is Edith Rivero, i am a peruvian woman who is engaged into Open Source since 2010 but just like an user, willing someday participating in a real way. Sincerely it was really great for me that the past FUDCON took place on my city (Cusco). Participating as a helper in the conference encouraged me to look for a project to contribute with. I choosed Documentation Project because through documents i could be better involved into Fedora and maybe later join to another project :) What other projects or writing have you worked on in the past? This would be my first time participating on writing, but during my university times I have participated using Latex tool to transcrive some papers. Some other projects I worked on, were those related to information security. This is an interesting field for me, so if I could choose to start any documentation I would like to start in this field. But of course, I will work willingly in any documentation required to be done. What level and type of computer skills do you have? I hope to measure it well. I did most of my programming activities on Java, so i would say i have an intermediate level. Also, I got involved to Php, XML (both intermediae level), Python (basic level) and databases MySQL, PosgreSQL (both intermediate level) and Oracle (basic level). During my last job I also used tools of Lotus Notes. What other skills do you have that might be applicable? Well, I have soft-called skills analytical skills, technical skills in programming and training skills (my actual job is teaching in an IT technical school on the University). Also I can understand things easyly and I like to investigate. What makes you an excellent match for the project? My perseverance and my dedication are some of my qualities I am going to maintain through this project. Maybe I will have to confront with some tools or kind of work that i never used to, but i like challenging things and I will make my best effort to solve this in the way it is expected. How much time you can contribute (usually hours per week)? I measured my time, and i decided to contribute 6 hours a week to begin. GPG KEYID and fingerprint: [root@localhost erivero]# gpg --fingerprint 90CCC38Apub 2048R/90CCC38A 2013-10-21 [expires: 2015-10-21]Key fingerprint = 2698 9C33 AB4A 3881 163B 40F6 8240 4D8B 90CC C38A uid Edith Pamela Rivero Tupac <edith.tupac(a)gmail.com>sub 2048R/85A508CF 2013-10-21 [expires: 2015-10-21] Sincerely it will be a pleasure to contribute this Fedora's project. Thank you for taking time to read this email. It will be really great if I got answers of you. Best regards, Edith Rivero

2 2

Changes/Features?
by Christopher Meng 23 Oct '13

23 Oct '13

Hi, Since F20 we now define features as "Changes", however I still can see: Fedora 20 features <productname>Ryu</productname>, software that enables effective, software defined networking for <productname>OpenStack</productname> virtualization. in the transifex pot. Maybe we should change, too? Thanks. -- Yours sincerely, Christopher Meng Fєdоґa ї₴ al$о a кїпd оf нaт lїкє Яёd Haт. http://cicku.me

4 4

Fedora Docs Meeting Summary for 21OCT2013
by Pete Travis 21 Oct '13

21 Oct '13

1 0

Fwd: Fedora 20 Beta Release Announcement Draft
by Pete Travis 18 Oct '13

18 Oct '13

---------- Forwarded message ---------- From: "Pete Travis" <lists(a)petetravis.com> Date: Oct 16, 2013 12:20 PM Subject: Fwd: Fedora 20 Beta Release Announcement Draft To: "Pete Travis" <me(a)petetravis.com> Cc: ---------- Forwarded message ---------- From: "Joe Brockmeier" <jzb(a)redhat.com> Date: Oct 16, 2013 6:55 AM Subject: Fedora 20 Beta Release Announcement Draft To: "Fedora Marketing" <marketing(a)lists.fedoraproject.org> Cc: Hi all, We're coming up on the delivery date for the beta release announcement, so I've taken the liberty of getting started on that. You'll find the draft here: https://fedoraproject.org/wiki/F20_Beta_release_announcement If it looks eerily similar to the alpha announcement, that's because it (mostly) is. Next steps are to go through and see what's been completed between the alpha and beta stages, and add/remove things as necessary to ensure that this hits the most important points for the beta. Thoughts, comments, flames? Best, jzb -- Joe Brockmeier | Open Source and Standards, Red Hat jzb(a)redhat.com | http://community.redhat.com/ Twitter: @jzb | http://dissociatedpress.net/ -- marketing mailing list marketing(a)lists.fedoraproject.org https://admin.fedoraproject.org/mailman/listinfo/marketing

3 3

Defensive and secure coding guide: call for renaming files
by Jérôme Fenal 10 Oct '13

10 Oct '13

Hi all, The Defensive and coding guide sports an interesting and forgotten feature in its file organization: directories. Beyond directories, it also happens to show files having the same name (such as Language.xml, found in Python/, Java/, CXX/, C/, etc. or schema.xml). You tell me, that is what directories are for. Fair enough. The real issue here is that pushing .po resulting from those XML files to Transifex which only handles uniquely named resources in a flat hierarchy leads to a mess, where there is no predictibility in having the Language resource always the same on Transifex, depending how those are pushed. Could it be possible to rename all those files to unique names, ideally with the subdir as a prefix (such as CXX-Language.xml or C-schema.xml) so that we have unique resource names in Transifex? Furthermore, could we add a requirement to documentation authors in order to ensure that all XML files in their document hierarchy show unique names? Regards, J. -- Jérôme Fenal

5 11

How to manage a sorted list of words in a doc?
by Jérôme Fenal 10 Oct '13

10 Oct '13

Hi there, Currently looking at the translation of the FreeIPA docs, the glossary will pose an interesting challenge: strings in the DocBook XML file are ordered, as those are supposed to be in the alphabetic order. However, when the translation phase happens, words will change (obviously), and for latin alphabet-based languages (not speaking about other alphabets or languages not using an alphabet which will have the same kind of challenge, maybe not based on word initials), the initials of those words won't be kept. And thus the order of appearance for the words. Would you have a recommendation about the technique to use to handle such a sorted list of words, where the order would be kept, using DocBook? Regards, J. -- Jérôme Fenal

3 4

[PATCH] Networking release notes - some Docbookification
by Brad Ackerman 08 Oct '13

08 Oct '13

Took Pete's draft NetworkManager/BlueZ language, and the nmcli new features, and DocBooked them. -- Brad Ackerman N1MNB PGP: 0x9F49A373 brad(a)facefault.org <*> http://bsa.smugmug.com/

1 0

Fedora Docs Meeting Minutes for 30SEP2013 and 07OCT2013
by Pete Travis 07 Oct '13

07 Oct '13

==================================================================================================== #fedora-meeting: Docs Project Meeting - Agenda: https://fedoraproject.org/wiki/Docs_Project_meetings ==================================================================================================== Meeting started by randomuser at 14:02:43 UTC. The full logs are available at http://meetbot.fedoraproject.org/fedora-meeting/2013-10-07/fedora_docs.2013… . Meeting summary --------------- * Roll Call (randomuser, 14:02:43) * Release Notes - Changes (randomuser, 14:05:51) * LINK: http://fedorapeople.org/groups/schedule/f-20/f-20-docs-tasks.html (randomuser, 14:07:14) * beats on the wiki are closed, according to the schedule. Further work should be done in git. (randomuser, 14:16:50) * Please commit and push *often* (randomuser, 14:17:20) * new writers (randomuser, 14:37:19) * new writers ( and old ) can find help from the group (randomuser, 14:38:00) * LINK: https://fedoraproject.org/wiki/Docs_Project_mentors (randomuser, 14:38:09) * ACTION: randomuser to add irc nicks to https://fedoraproject.org/wiki/Docs_Project_mentors (randomuser, 14:49:43) * open floor (randomuser, 14:54:12) Meeting ended at 15:00:05 UTC. Action Items ------------ * randomuser to add irc nicks to https://fedoraproject.org/wiki/Docs_Project_mentors Action Items, by person ----------------------- * randomuser * randomuser to add irc nicks to https://fedoraproject.org/wiki/Docs_Project_mentors * **UNASSIGNED** * (none) People Present (lines said) --------------------------- * randomuser (73) * lnovich (28) * pbokoc (18) * iWelcome (13) * jjmcd (10) * zodbot (3) * Capesteve (2) * yruseva (1) Generated by `MeetBot`_ 0.1.4 .. _`MeetBot`: http://wiki.debian.org/MeetBot ==================================================================================================== #fedora-meeting: Docs Project Meeting - Agenda: https://fedoraproject.org/wiki/Docs_Project_meetings ==================================================================================================== Meeting started by randomuser` at 14:00:09 UTC. The full logs are available at http://meetbot.fedoraproject.org/fedora-meeting/2013-09-30/fedora_docs.2013… . Meeting summary --------------- * Roll Call (randomuser`, 14:00:09) * Participants are reminded to make liberal use of #info #link #help in order to make the minutes "more better" (randomuser`, 14:02:52) * follow up on last week's action items (randomuser`, 14:06:20) * ACTION: randomuser to complete change tracking bugs (randomuser`, 14:06:29) * Release Notes / Changes (randomuser`, 14:06:55) * LINK: http://fedorapeople.org/groups/schedule/f-20/f-20-docs-tasks.html (randomuser`, 14:07:45) * Alpha RNs have been skipped, in favor of Release Announcement; marketing has cycles to create copy and docs did not (randomuser`, 14:08:27) * very few beats have had content added to them (randomuser`, 14:12:22) * lots of beat writing to do; make sure to communicate what you are working on somehow so we don't overlap (randomuser`, 14:17:43) * LINK: https://fedoraproject.org/wiki/Documentation_Virtualization_Beat (randomuser`, 14:24:58) * Guide Status (randomuser`, 14:27:05) * Outstanding BZ Tickets (randomuser`, 14:29:38) * LINK: http://tinyurl.com/lbrq84 (randomuser`, 14:29:43) * Open Floor Discussion (randomuser`, 14:33:08) Meeting ended at 14:41:29 UTC. Action Items ------------ * randomuser to complete change tracking bugs Action Items, by person ----------------------- * **UNASSIGNED** * randomuser to complete change tracking bugs People Present (lines said) --------------------------- * randomuser` (41) * lnovich (13) * hk_ (7) * pbokoc (4) * zodbot (3) * jhradilek (3) * jreznik (3) * Capesteve (3) * Sparks (2) * iwelcome (1) Generated by `MeetBot`_ 0.1.4 .. _`MeetBot`: http://wiki.debian.org/MeetBot -- -- Pete Travis - Fedora Docs Project Leader - 'randomuser' on freenode - immanetize(a)fedoraproject.org

1 0

2024

2023

2022

2021

2020

2019

2018

2017

2016

2015

2014

2013

2012

2011

2010

2009

2008

2007

2006

2005

2004

2003

2002

docs October 2013