Home > Fedora Documentation Project > Publican Documentation Naming

Publican Documentation Naming


Earlier today the Fedora Packaging Committee (FPC) looked at two
“obstacles” to Publican-generated documentation. The first was the
naming convention[1] and the second was how Publican handles
the .desktop in the SPEC file[2]. Both passed the FPC.

The FPC did say that we (the Docs Project) need to create a review
process to ask “is this documentation really version specific? is there
value in having multiple releases in the same dist at once?”. This is
an important test that we need to develop and handle in-house. This is
NOT a solution to allow all Publican documents but it is a solution for
allowing release-specific documents in Fedora.

Also discussed was the multiple SRPMs that are generated by having
multiple languages for each document. To simplify the process of
reviewing these it was suggested that we use subpackaging. Each SRPM
for each language would be wrapped into a single package.

I’m adding these three items to the agenda for this week’s Docs
meeting[3].

[1] http://fedoraproject.org/wiki/PackagingDrafts/DocumentationNaming
[2] http://fedoraproject.org/wiki/PackagingDrafts/EmbeddedDesktopFiles
[3]
http://fedoraproject.org/wiki/Docs_Project_Steering_Committee_meetings

Thanks,
Eric

Advertisements
  1. No comments yet.
  1. No trackbacks yet.

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s