Open Help Conference 2015
by Shaun McCance
Hi all,
I wanted to let you know that the Open Help Conference is happening
again this year, Sept 26-27.
http://conf.openhelp.cc/
This will be year 5. It would be great to see some friendly Fedora faces
again. After the conference, we also host three days of team sprints.
Any team is welcome to join for a sprint. We supply the rooms and the
supplies. You supply the people.
Let me know if you have any questions.
Thanks,
Shaun
8 years, 4 months
Publishing for Fedora 22
by Petr Bokoc
Hey all,
First of all, thanks to everyone who contributed to docs for Fedora 22.
We're in a much better state for this release than we were for the last
one, with significantly more books ready to be published on day one. We
still have a long way to go till we have a full documentation set, but
it's a big improvement nonetheless.
Below is the list of guides which can definitely be safely published
tomorrow. Publishing-ready branches are in parentheses:
* https://git.fedorahosted.org/cgit/docs/release-notes.git/ (f22)
* https://git.fedorahosted.org/cgit/docs/install-guide.git/ (f22-branch)
* https://git.fedorahosted.org/cgit/docs/selinux-guide.git/ (F22)
*
https://git.fedorahosted.org/cgit/docs/virtualization-getting-started-gui...
(f22)
-----
* https://git.fedorahosted.org/cgit/docs/networking-guide.git/ (22)
NOTE: Capesteve still needs to make some commits, but will be ready
tomorrow.
-----
*
https://git.fedorahosted.org/cgit/docs/system-administrators-guide.git/
(f22) - NOTE: It will be ready tomorrow, but jhradilek wants to add a
chapter on Systemd; he says he'll be done by Thursday. I don't know if
we should publish it ASAP and then republish it a few days later, or if
we should wait - I think it's ok to just wait a few days. Randomuser
should probably have the final word since he'll be the one publishing it
(probably).
Also, I remember seeing some activity in a few other books (Amateur
Radio Guide, Multiboot Guide, possibly some others), but I don't know
what their status is. *If there are any other guides ready for F22 and
they're not listed above, please reply to list and add their info
(repository and branch).*
Regarding the actual publishing - I remember randomuser said he'd do it,
so hopefully we're covered; pkovar offered assistance if needed.
Cheers,
Petr
8 years, 4 months
Re: Docs on the wiki (was: Regarding Fedora badges for Beat Writing)
by Ben Cotton
On May 22, 2015 9:51 PM, "Matthew Miller" <mattdm(a)fedoraproject.org> wrote:
>
> I think our basic goal is moving _user docs_ away from the wiki
> entirely, and keeping it as a contributor workspace only -- good for
> drafts, for test matrices, etc -- but anything that users would hit
> should be on future new "short, more-polished userdocs site". (Anyone
> disagree?)
>
I have no shortage of opinions on the matter, but the TL;DR is that I
vehemently agree with this. I'm generally opposed to wikis as documentation
for a variety of reasons, but they do have certain appealing traits.
If we use them for anything, it should be a drafting ground for new
content. Of course, that means doing most of the markup after the fact,
which has its own disadvantages, but it lowers the bar for new contributors
to come in.
8 years, 4 months
Fwd: Fedora documenation -- installation guide and other guides. General comment.
by Pete Travis
---------- Forwarded message ----------
From: "Leslie S Satenstein" <lsatenstein(a)yahoo.com>
Date: May 20, 2015 10:51 AM
Subject: Fedora documenation -- installation guide and other guides.
General comment.
To: "Pete Travis" <me(a)petetravis.com>, "docs-request(a)lists.fedoraproject.org"
<docs-request(a)lists.fedoraproject.org>
Cc:
> I started to review the guide and realized, like many others, that one
chapter or section is not included. That one is an address to the reader.
>
> Should a brief paragraph not be included that stipulates what knowledge
and skills the reader is recommended to have?
> Should there be a very short set of references for the reader, to where
he could rapidly and in a general level, obtain said knowledge and skills?
>
> Regards
>
> Leslie
> Mr. Leslie Satenstein
> Montréal Québec, Canada
>
This sounds like a path to scope creep to me, and something akin to "You
must be at least this experienced with Fedora to install Fedora" would be
off-putting. The more complex sections, ie kickstart, are already marked
as such.
We have been discussing targeting archetypal personas with future
documentation, and representing the skill/complexity/experience level
required in an unobtrusive way. I'll pass this on to the list for
comment. You should also review the list archives for discussions about
personas, and https://fedoraproject.org/wiki/Docs_Project_Focus .
On the last point, helping readers gain required skills and knowledge -
that's what we're all about :) Contributions welcome!
--Pete
8 years, 4 months
Fedora 22 Final Release Readiness Meeting :: Thursday, May 21, 19:00 UTC
by Jaroslav Reznik
Fedora 22 Final Release Readiness Meeting.
date: 2015-05-21 place: irc.freenode.net in #fedora-meeting-2
time: 19:00 UTC (3 PM EDT, 12 noon PDT, 21:00 CEST)
This Thursday, May 21, we will meet to make sure we are coordinated
and ready for the Final release of Fedora 22 on Tuesday, May 26, 2015.
Please note that this meeting will occur on May 21 even if the
release is delayed at the Go/No-Go meeting on the same day two hours
earlier.
You may received this message several times, but I was asked to open this
meeting to the teams and I'll also hope this will raise awareness and more
team representatives will come to this meeting. This meeting works best
when we have representatives from all of the teams. We also have a badge!
Jaroslav
8 years, 4 months
