docs September 2014

docs@lists.fedoraproject.org

23 participants
48 discussions

[Fedocal] Reminder meeting : Fedora Docs Weekly Meeting
by Pete Travis 14 Sep '14

14 Sep '14

Dear all, You are kindly invited to the meeting: Fedora Docs Weekly Meeting on 2014-09-15 from 14:00:00 to 15:00:00 UTC At fedora-meeting(a)irc.freenode.net The meeting will be about: An hour of docs folks talking about what they are working on and what they'd like to work on. More information available at: [https://fedoraproject.org/wiki/Docs_Project_meetings](https://fedoraproject… Source: https://apps.fedoraproject.org/calendar//meeting/371/

1 0

Introduction
by Roger Baran, Owner 14 Sep '14

14 Sep '14

Hello everyone! I would like to introduce myself. My name is Roger Baran. I started working with computers while stationed aboard the USS Tattnall (DDG-19) in 1980. I had a friend that was a DS (Data Systems Specialist) who worked in the ships computer room. He introduced me to DBase 3 and my life was changed forever. The first computer, I remember vividly, that I worked with was a Kaypro luggable. It had two floppy disks and a 6" monochrome crt and the keyboard attached to the front over the monitor. That thing must have weighed in at about 20 pounds! Armed with my four DBase 3 floppies (and another two or three for Wordstar) I was on top of the world. From there I went on to learn how to program the Sinclair and a TRS-80! In January of 1984 I bought my first PC - a generic 'IBM' desktop with two floppy drives, 64K of RAM and a 9" monochrome monitor. Those were the days! lol Tiring of the Navy, I crossed over to the US Coast Guard in 1990 and went on to become a Radarman Chief Petty Officer (E7). Over the years I have continued to work in the computer world either full or part time. My history includes building desktops from scratch at NCR of Jacksonville, Fl, to running a computer store for the same company, to working at Microsoft, to now running my own consulting practice here in San Antonio, TX. I first got involved with Linux sometime around 2009. Since then, I have installed, re-installed, and attempted to fix -- or get working -- literally dozens of different distro's. I always seem to spend more time working on them than using them! Recently, I have been drawn into the world of Penetration Testing and have expended a lot of time and energy with Kali Linux and Network Security Toolkit (based on Fedora 20). Working with NST 20 is what brought me to the Fedora forums in search of answers for dealing with Microsoft's blatant disregard for co-existence with other operating systems. Now, I will be working with randomuser to hopefully bring some of my own head banging experience to bear on helping others avoid the same. I have been writing technical articles and classroom instruction materials, teaching those materials in military classrooms, providing private instruction, posting on blogs, etc. for many years now. My largest, and most successful project was to write the Personnel Qualification Standards (PQS) for a newly installed HP-Mini based system used for coordinating real-time tactical data among various agencies (DEA, USCG, USN and Marine Corps, US Army and Air Force) aboard 378' cutters in the US Coast Guard. That documentation went on to be approved by the Secretary of Transportation and the Commandant of the Coast Guard as the official PQS for all 378' cutters with OTCIX (Office in Tactical Command Information Exchange) aboard. I look forward to contributing my skills and background to the group. As for the immediate future, I will be working on the multiboot guide under the watchful eye of randomuser. It will be a bit challenging as far as time is concerned; I have several somewhat needy clients! lol But, I am sure that I am not the Lone Ranger when it comes to needing a 30 hour day... Come what may, I will do what I can as often as I can. I also look forward to working with the group and getting to know you more as we interact online. BTW, having been in the military for so many years, my skin is pretty thick. Don't hesitate to jump in with constructive criticism where you feel you need to speak up about something I have written. *Constructive* is the operative word and with that, I am always grateful for another point of view. Feel free to shoot me an email directly for issues that don't need to be addressed with the entire group. My public key is attached. Please send signed/encrypted emails as much as possible: I am kind of a privacy nut -- increasingly so after getting involved with Penetration Testing! lol Have a great day everyone! -- Warm Regards, Roger Baran, Owner Rapid Recovery IT Services San Antonio, TX

1 0

@randomuser
by Roger Baran, Owner 13 Sep '14

13 Sep '14

Here is what I put together from our chat yesterday. Could you please review and tell me if I missed anything or if there is something you would like to add to it. I will be using this as a ready-ref as I get myself bootstrapped. Thank you in advance -- Warm Regards, Roger Baran, Owner Rapid Recovery IT Services San Antonio, TX

2 2

Re: Release notes have a launcher - maybe we should remove that
by Petr Kovar 11 Sep '14

11 Sep '14

On Fri, 05 Sep 2014 15:12:04 -0400 Matthias Clasen <mclasen(a)redhat.com> wrote: > On Fri, 2014-09-05 at 16:52 +0200, Petr Kovar wrote: > \ > > It could be gnome-documents as Matthias proposed if we choose to ship PDF > > instead of a bunch of HTML pages. > > > > It could be yelp as it supports transforming DocBook/Mallard XML as well as > > viewing HTML pages. I just tested it and yelp works quite well: > > > > $ yelp /usr/share/doc/fedora-release-notes/index.html > > I think all of these questions about formats and tools are a bit > secondary though. I agree that these are secondary as long as desktop users can find what they are looking for. Providing a docs search functionality would surely help with that need. > Having the release notes on the system really makes most sense if we > actually make an effort to present them to the user when he would be > most interested in seeing them - right after installation. +1 > The current post-install workflow already launches yelp with the > gnome-getting-started guide. Maybe that page can be expanded to include > the release notes in some form ? Yes, this is something we can do. Assuming that we want to provide a link to the Release Notes from the GNOME Getting Started landing page, there are multiple ways to approach this. As I said, we could add the link upstream and use Mallard conditionals to only display the link on Fedora since the link is downstream-specific. We could also provide a downstream patch but translations would be a problem then. GNOME Initial Setup could also get an extra button that would launch the Release Notes. Cheers, pk

4 7

[Fedocal] Reminder meeting : Docs Office Hours ( Americas )
by Pete Travis 10 Sep '14

10 Sep '14

Dear all, You are kindly invited to the meeting: Docs Office Hours ( Americas ) on 2014-09-11 from 12:00:00 to 13:00:00 US/Mountain The meeting will be about: Office hours for Fedora Docs contributors. Stop in to #fedora-docs for help with writing documentation or just to schmooze with the Docs community. Bring your own cake. Source: https://apps.fedoraproject.org/calendar//meeting/434/

1 0

Meeting
by John J. McDonough 08 Sep '14

08 Sep '14

Sorry I didn't make the meeting AGAIN. Lately seems like things keep happening on Monday. Today it was my annual finger up the butt. The good news is I don't have to do that for another year. Next week I'll be in Lansing for a meeting with FEMA. But the following week looks good (sigh). I have been wanting to bring up some ideas on re-use of doc segments. That discussion seems to have died out. Was there a resolution that I missed or did it just fade into the sunset? --McD

3 3

Re: Release notes have a launcher - maybe we should remove that
by Elad Alfassa 08 Sep '14

08 Sep '14

On Tue, Sep 2, 2014 at 3:38 PM, Michael Catanzaro <mcatanzaro(a)gnome.org> wrote: > On Tue, 2014-09-02 at 09:41 +0100, Marco Scannadinari wrote: >> To me a perfect solution would be to place the release notes in >> gnome-control-center's 'Details' section. It seems like an >> appropriate >> location and is better suited to these sorts of things since it is >> not >> somewhere like ~/Documents in which they are user-removable. >> This approach would of course require downstream patches, however. > > Or we could display them on an optional spoke in anaconda. > > -- > desktop mailing list > desktop(a)lists.fedoraproject.org > https://admin.fedoraproject.org/mailman/listinfo/desktop That's just silly. -- -Elad Alfassa.

3 2

[Fedocal] Reminder meeting : Fedora Docs Weekly Meeting
by Pete Travis 07 Sep '14

07 Sep '14

Dear all, You are kindly invited to the meeting: Fedora Docs Weekly Meeting on 2014-09-08 from 14:00:00 to 15:00:00 UTC At fedora-meeting(a)irc.freenode.net The meeting will be about: An hour of docs folks talking about what they are working on and what they'd like to work on. More information available at: [https://fedoraproject.org/wiki/Docs_Project_meetings](https://fedoraproject… Source: https://apps.fedoraproject.org/calendar//meeting/371/

1 0

Re: Release notes have a launcher - maybe we should remove that
by Matthew Miller 05 Sep '14

05 Sep '14

On Fri, Sep 05, 2014 at 03:12:04PM -0400, Matthias Clasen wrote: > Having the release notes on the system really makes most sense if we > actually make an effort to present them to the user when he would be > most interested in seeing them - right after installation. > > The current post-install workflow already launches yelp with the > gnome-getting-started guide. Maybe that page can be expanded to include > the release notes in some form ? Makes sense. And in the future, it would also be nice to have them nicely visible in the event of an upgrade from one Workstation release to the next — or even presented in some way when a release-to-release update is _available_. -- Matthew Miller <mattdm(a)fedoraproject.org> Fedora Project Leader

1 0

Re: Release notes have a launcher - maybe we should remove that
by Jared K. Smith 05 Sep '14

05 Sep '14

On Fri, Sep 5, 2014 at 7:21 AM, Bastien Nocera <bnocera(a)redhat.com> wrote: > Search providers are all backed by applications. What's the application > to read the docs in /usr/share/help? > That would depend on the format, I think. A browser for HTML docs, evince for PDF, or Yelp for DocBook/Mallard. > It would probably be better to have those docs be converted to something > Yelp > can read and integrated in the Help, at least for GNOME and for > Workstation. > The release notes, like most of the docs written the Docs team, are already written in DocBook, which Yelp handles just fine. The docs team can also easily convert them to PDF, HTML (multi-page), HTML (single-page), and even Markdown (with the latest release of the Publican tool). In short, I don't think conversion is a problem here -- we simply need to agree on what format(s) we want, and figure out the new workflow. -- Jared Smith

1 0

2025

2024

2023

2022

2021

2020

2019

2018

2017

2016

2015

2014

2013

2012

2011

2010

2009

2008

2007

2006

2005

2004

2003

2002

docs September 2014