[Bug 627417] New: docs.fp.o landing page needs 'Start here' note!
by Red Hat Bugzilla
Please do not reply directly to this email. All additional
comments should be made in the comments box of this bug.
Summary: docs.fp.o landing page needs 'Start here' note!
https://bugzilla.redhat.com/show_bug.cgi?id=627417
Summary: docs.fp.o landing page needs 'Start here' note!
Product: Fedora Documentation
Version: devel
Platform: All
OS/Version: Linux
Status: NEW
Severity: medium
Priority: low
Component: docs-requests
AssignedTo: eric(a)christensenplace.us
ReportedBy: nathan.thomas(a)peacenik.co.uk
QAContact: fedora-docs-list(a)redhat.com
CC: stickster(a)gmail.com, kwade(a)redhat.com,
nb(a)fedoraproject.org
Classification: Fedora
Description of problem:
We have a large variety of documentation guides serving a wide range of
different users. It may be difficult for users arriving at docs.fp.o to know
where to start, especially if they are new to Fedora/Linux and are unfamiliar
with some of the technical terms.
A note on the landing page suggesting a sensible starting point for new users
could help alleviate this problem. Eg:
"New to Fedora? You can try Fedora on your PC without touching your existing
installation by following the Live Image Guide."
The end of the Live Image guide helpfully points users to the Installation
guide if they want to install :)
--
Configure bugmail: https://bugzilla.redhat.com/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the QA contact for the bug.
8 years, 4 months
[Bug 654484] New: New Bugzilla component for Storage Administration Guide
by Red Hat Bugzilla
Please do not reply directly to this email. All additional
comments should be made in the comments box of this bug.
Summary: New Bugzilla component for Storage Administration Guide
https://bugzilla.redhat.com/show_bug.cgi?id=654484
Summary: New Bugzilla component for Storage Administration
Guide
Product: Fedora Documentation
Version: devel
Platform: Unspecified
OS/Version: Unspecified
Status: NEW
Severity: medium
Priority: low
Component: docs-requests
AssignedTo: eric(a)christensenplace.us
ReportedBy: r.landmann(a)redhat.com
QAContact: fedora-docs-list(a)redhat.com
CC: stickster(a)gmail.com, kwade(a)redhat.com,
nb(a)fedoraproject.org
Classification: Fedora
Target Release: ---
Please create a component for the Storage Administration Guide; default
assignee should be ddomingo(a)redhat.com
Cheers
Rudi
--
Configure bugmail: https://bugzilla.redhat.com/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the QA contact for the bug.
8 years, 5 months
[Bug 450331] New: lack of documentation on restoring from bare-metal (UUID problem)
by Red Hat Bugzilla
Please do not reply directly to this email. All additional
comments should be made in the comments box of this bug report.
https://bugzilla.redhat.com/show_bug.cgi?id=450331
Summary: lack of documentation on restoring from bare-metal (UUID
problem)
Product: Fedora Documentation
Version: devel
Platform: All
OS/Version: Linux
Status: NEW
Severity: low
Priority: low
Component: docs-requests
AssignedTo: kwade(a)redhat.com
ReportedBy: czar(a)acm.org
QAContact: stickster(a)gmail.com
CC: fedora-docs-list(a)redhat.com
Description of problem:
ref: https://bugzilla.redhat.com/show_bug.cgi?id=449299
There is a lack of documentation on restoring a system from bare metal. I have
found (see reference) that restore the root ("/") is not as simple as as just
executing the restore command when running in rescue mode.
With the current emphasis being place on use of UUIDs in both Fedora and RHEL,
the whole business of UUIDs need to be better documented.
Version-Release number of selected component (if applicable):
Fedora 9
--
Configure bugmail: https://bugzilla.redhat.com/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are on the CC list for the bug, or are watching someone who is.
10 years, 2 months
[Bug 595695] New: Direct links to RNs broken.
by Red Hat Bugzilla
Please do not reply directly to this email. All additional
comments should be made in the comments box of this bug.
Summary: Direct links to RNs broken.
https://bugzilla.redhat.com/show_bug.cgi?id=595695
Summary: Direct links to RNs broken.
Product: Fedora Documentation
Version: devel
Platform: All
OS/Version: Linux
Status: NEW
Severity: medium
Priority: low
Component: docs-requests
AssignedTo: eric(a)christensenplace.us
ReportedBy: eric(a)christensenplace.us
QAContact: fedora-docs-list(a)redhat.com
CC: stickster(a)gmail.com, kwade(a)redhat.com
Classification: Fedora
Description of problem:
* Previously, the release notes were located at
http://docs.fedoraproject.org/release-notes/
* Their location has changed to release specific URLs.
* A link to the release notes is provided in fedora-bookmarks.
* fedora-bookmarks are imported by the browser only on *first launch* so as to
not overwrite user modifications.
The new bookmarks layout causes two problems:
1. Nobody filed a fedora-bookmarks bug so Fedora 13 (and anyone on F-11 or F-12
etc) will default to going to http://docs.fedoraproject.org/release-notes/
which is a 404. Since the bookmarks can only be imported on first launch, we
cannot push an update to fix this if the user has launched the browser (which
is extremely likely).
2. Even if I were to fix the bookmarks page to point directly to a specific
release version (which again would take effect only if someone would yum update
before launching Firefox), then if anyone updated to F-14, the bookmark would
not change and would still point to e.g. F-13.
So, I do not think that we should put version specific information into our
bookmarks URLs. To solve both of the above problems, I believe we should try to
do some User-Agent detection and redirection. Fedora browsers have an RPM NVR
attached to them.
For example:
Mozilla/5.0 (X11; U; Linux x86_64; es-ES; rv:1.9.2.4) Gecko/20100517
Fedora/3.6.4-1.fc13 Firefox/3.6.4
This tells us that the user's installed language is es-ES and it's a Fedora
browser, specifically running F-13. We should then redirect queries to
http://docs.fedoraproject.org/release-notes/ to
http://docs.fedoraproject.org/es-ES/Fedora/13/html/Release_Notes/index.html
If we cannot figure any information out about the Fedora release or language
(or there are no relnotes in that language), I propose the default redirect
should be to the en-US version of the latest Fedora release notes.
--
Configure bugmail: https://bugzilla.redhat.com/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the QA contact for the bug.
10 years, 9 months
[Bug 504066] New: CMS for docs.fp.org
by Red Hat Bugzilla
Please do not reply directly to this email. All additional
comments should be made in the comments box of this bug.
Summary: CMS for docs.fp.org
https://bugzilla.redhat.com/show_bug.cgi?id=504066
Summary: CMS for docs.fp.org
Product: Fedora Documentation
Version: devel
Platform: All
OS/Version: Linux
Status: NEW
Severity: medium
Priority: low
Component: project-tracking
AssignedTo: kwade(a)redhat.com
ReportedBy: mel(a)redhat.com
QAContact: kwade(a)redhat.com
CC: fedora-docs-list(a)redhat.com
Classification: Fedora
Zikula chosen, working on test instances and project plan with Zikula team
--
Configure bugmail: https://bugzilla.redhat.com/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are on the CC list for the bug.
11 years, 11 months
Musicians' Guide Links Are Broken
by Christopher Antila
Hello:
As per this bug 665663 (see below [0]), all of the links to tutorial
files in the Fedora 14 Musicians' Guide are broken. Most of the chapters
work on the idea that users will download some files to start the
tutorial, then use those files to develop their own fully-completed
project. Without these files, users can only complete some of the
tutorials - many of the chapters are useless, because the URLS are
incorrect!
I'll fix this in the master branch tonight, but should I fix it in the
published document as well?
Thanks,
Christopher.
[0] https://bugzilla.redhat.com/show_bug.cgi?id=665663
12 years, 1 month
Re: Please tutor a crash course on Docs Project tools & workflow.
by Christopher Antila
On Sat, 2011-01-22 at 12:00 +0000, docs-request(a)lists.fedoraproject.org
wrote:
> Date: Sat, 22 Jan 2011 06:45:16 +0000 (UTC)
> From: Jes?s Franco <tezcatl(a)fedoraproject.org>
> Subject: Re: Please tutor a crash course on Docs Project tools &
> workflow.
> To: docs(a)lists.fedoraproject.org
> Message-ID: <pan.2011.01.22.06.45.15(a)fedoraproject.org>
> Content-Type: text/plain; charset=UTF-8
>
> El Thu, 20 Jan 2011 17:56:23 -0500, Christopher Antila escribi?:
> Thank you Christopher for your encouraging words. It's really
important
> to me for continue this effort. But my proposal was not a document or
> guide covering the topics for beginner contributors. It is for a
class
> (or two) delivered on IRC as part of the Classroom initiative.
Sorry - I misunderstood what you meant. I do not know much about Fedora
Classroom, but this also sounds like a good idea.
> ...
>
> I'd be glad to write the whole guide (as complement to Publican User
> Guide), but maybe i'm the last person with the knowledge necessary to
> commit that, on this list. I've commited just a few minor tasks, (i'm
most
> a translator), and maybe my whole knowledge related to DocBook is the
> most basic of HTML and XML.
>
> However, you can count with when i get the knowledge needed, i'll
commit
> the task for myself. I've even delivered a first class (in my mother
> language, castilian) for my fellow ambassadors on the basics of our
> ticketing system at latam (Redmine). I'm not shy to share even a
little
> amount of knowledge (should i be?). Just i like to get more knowledge
to
> do a more valuable contribution.
You can start the project, then learn how to finish it as you go. If you
make a good plan before you start, other contributors might want to help
you finish (I certainly will)! This is one of the benefits of
open-source development. If we had to wait for somebody who knows
*everything* about a project before it starts, we would be waiting for a
very long time.
> At the first very time the QA process was proposed for guides, one
idea
> was something like "peer review" by another Doc contributor, able to
read
> the whole guide and making proposal for improvement, in the form of
real
> patches, apart from bugs filed against the guide.
>
> My feeling is than QA shouldn't be a bureaucratic blocking for writers
to
> commit the actual writing and maintenance of the guide for continuous
> improvement. It should be a way for let less experienced contributors
to
> help with the owners of the guides, but we need at least a minimum
> training to do so.
I agree that the QA process should not block writers from committing.
What would be nice is for a QA person to ensure that every Bugzilla bug
has been successfully solved. This can be done after the fix has already
been committed. Also, if a writer, whether new or experienced, wishes to
have their work approved by QA, they could make a bug request.
Christopher.
12 years, 4 months
[Bug 673612] New: Collapsible guides menu button on docs.fedoraproject.org as seen in docs.redhat.com
by Red Hat Bugzilla
Please do not reply directly to this email. All additional
comments should be made in the comments box of this bug.
Summary: Collapsible guides menu button on docs.fedoraproject.org as seen in docs.redhat.com
https://bugzilla.redhat.com/show_bug.cgi?id=673612
Summary: Collapsible guides menu button on
docs.fedoraproject.org as seen in docs.redhat.com
Product: Fedora Documentation
Version: devel
Platform: Unspecified
OS/Version: Unspecified
Status: NEW
Severity: unspecified
Priority: unspecified
Component: docs-requests
AssignedTo: nobody(a)fedoraproject.org
ReportedBy: ronin3510(a)gmail.com
QAContact: fedora-docs-list(a)redhat.com
CC: stickster(a)gmail.com, kwade(a)redhat.com,
nb(a)fedoraproject.org, eric(a)christensenplace.us,
oglesbyzm(a)gmail.com
Classification: Fedora
Description of problem:
The feature I'm talking about is newly added in docs.redhat.com and greatly
enhances readability and usability, both on desktop/laptop and mobile devices,
and since it already exists, it should be pretty trivial to backport it on
Fedora Docs. It's a small button in the upper part of the guides section that
can be toggled to hide the guides list after choosing the desired
guide/chapter. It appeared on docs.redhat.com in the last few weeks, and it
wasn't available on RHEL 6 launch day (Nov 10, 2010). I mentioned that to
narrow the timeframe a bit.
Thank you.
Version-Release number of selected component (if applicable):
How reproducible:
Contrast and compare
docs.redhat.com
docs.fedoraproject.org
Steps to Reproduce:
1.Try to read a guide in a browser
2.Try to read a guide in a mobile browser on docs.fedoraproject.org
3.Try to read a guide in a mobile browser on docs.redhat.com using the
aforementioned button switch
Actual results:
docs.fedoraproject.org is almost unusable on mobile devices and not so great on
a bit larger displays. like small laptops and netbooks
Expected results:
There's no reason not having the same streamlined reading experience on both
documentation sites.
Additional info:
--
Configure bugmail: https://bugzilla.redhat.com/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the QA contact for the bug.
12 years, 4 months
Wiki Cleanup
by Zach Oglesby
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1
If no one has any arguments, I would like move all of the Beats pages into a sub category on the Wiki. Currently when you look at the main Docs_Project cat, you get a cluttered mess of mostly release notes beats. I would like to move them to a RN_Beats category to clean up the main page. Any objections?
- --
Zach Oglesby
GPG Key: F20C4707
zoglesby on irc.freenode.net
https://fedoraproject.org/wiki/User:Zoglesby
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.11 (GNU/Linux)
iQEcBAEBAgAGBQJNRWVYAAoJENs2/YnyDEcH01IH/Ao2kByq4Nn99bGdzrJGYz5Z
QtTn1NdhR5vZFW+zpNE4Yf/HcMLgByTGyACpURrlAbrKrp55Y9GzzEZ/zFYY4kpc
ZNFyBmScVO/jbErC47/2y0zG59/npGGwMO0F5Gandn6X7TssTAQFeTZmBX1TcJQ3
Se05DSdpZhCHGu7jMkH6Vb1vaEqREj0Vm6kUfUsUphEX5ajg56aW+x5IvgnRxLD5
dTjhZu8IGRSLUqpwKzKC8I49MOqqv1bpPG3ojYSMWvhMJxOK6yFvIoMUSTDFc1qe
NEJXZRIYHUsO56ztuFlh9V5ntZE9/gKC+qih3M6JYiucvXvzA5/sZlumCQ/K/3E=
=/ml+
-----END PGP SIGNATURE-----
12 years, 4 months
Self Introduction:
by Matt
Hello!
My name is Matt Offers, and I wanna help out. I am a recent college graduate
who's looking to get some experience with both linux and technical writing.
I have a friend who has been contributing to the Fedora project for years
and who has been trying to get me involved for years. Computer-wise my
background is in OS X, but I've used a few linux distros including Fedora,
and I am in love with the open source world. I'm currently having a little
bit of trouble setting up Fedora on my test machine in my room (for some
reason it doesn't have a proper NIC, and only an old Linksys wireless card
for which I'm having trouble finding the drivers for) but as soon as I get
it up and running I'll be able to generate my GPG key and all that jazz. I
look forward to contributing as much as I can, and learning from all of you.
-Matt Offers
12 years, 4 months