[Pulp-list] User Guide Updates

Jay Dobies jason.dobies at redhat.com
Wed Mar 9 15:40:02 UTC 2011


-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

I did some cleanup of the user guide this morning. The repo page was
getting pretty large, so I pulled out errata and distributions so that
each have their own page.

A few reminders based on other changes I made:

- - If you add a new section (something large enough that made you think
to use the #section notation to identify it), don't forget to add a link
to it from the main User Guide table of contents.

- - When documenting commands that can process one or more things, be sure
to indicate how to specify multiple items. For instance: "-f or --files
 File(s) to remove to this repository." doesn't indicate if multiple
files should be comma-separated, use multiple instances of the -f flag,
or some other means. This is also a case where an example helps.

- - Please remember to proofread your docs, especially since these are
user-facing. There were a number of typos that I corrected. Also
remember that these are user docs and, while not the most formal guide
in the world, still should follow some basic grammar. Two examples:

* "Associate a package to a repository." - This is fine for a --help
entry, but try to use full sentences in the user guide.
* "from pulp server" - Should be "from the Pulp server". Also, remember
to capitalize Pulp when referring to the project itself.

- - Please fire off a quick e-mail to the team that the docs have been
updated to request a proofreader. A second pair of eyes will often see
all the little typos that the writer's eyes gloss over.


Thanks  :)

- -- 
Jay Dobies
RHCE# 805008743336126
Freenode: jdob
http://pulpproject.org
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2.0.14 (GNU/Linux)
Comment: Using GnuPG with Fedora - http://enigmail.mozdev.org/

iQEcBAEBAgAGBQJNd59SAAoJEOMmcTqOSQHCNwQIAKe3c1srTdWWIa5ngP023ZZA
C0paIUKhT4WVcCvKc6nbAE1MxpOFMU+5Z0ZwXhJwtjCdJpHG7R0NsrBxRBMPvIV2
Ww2ilpwafKJLtaDjYB/wY3AtOATkkxqRne2gk3c9TxxUTCoUPRhXbVLeV12qv79K
0nwW9/l+LYc8gyzUcEsXacrpc/eLFghy+/56/olerACCYsOgtraNeZ4Lta2HdeXb
yz7Nj4DCIwlJIlkQ5SFZf19YvTYae+mAre1jzQPuRZdSx/pLqLS6xpj64heS7RmY
syledaPr5bvb6XMtsvaZhPURgxsjCW06b3byh2H4AIKfFw98muubS8drN4tAYqo=
=KdVY
-----END PGP SIGNATURE-----




More information about the Pulp-list mailing list
https://listman.redhat.com/archives/pulp-list/2011-March/000779.html
listman.redhat.com
CC-MAIN-2023-23
5078
application/http; msgtype=response
sha1:7ISAE4XJFB6MAVZYSL6W6RHD4NAXQTHK
<urn:uuid:c4a03edc-3401-427f-bd3a-145c395b4a5e>
2023-06-03T11:26:33Z
23.33.255.147
text/html
sha1:W7E3UIJLUSMGZ2WUEHXLWGQTO4BTYX7E
<urn:uuid:91f90c40-45c9-4e35-a1de-8c14c3aafa70>
https://listman.redhat.com/archives/pulp-list/2011-March/000779.html
response
<urn:uuid:6b4491e1-fbe3-4fc3-af6f-71b7fd08d469>
isPartOf: CC-MAIN-2023-23
publisher: Common Crawl
description: Wide crawl of the web for May/June 2023
operator: Common Crawl Admin (info@commoncrawl.org)
hostname: ip-10-67-67-229
software: Apache Nutch 1.19 (modified, https://github.com/commoncrawl/nutch/)
robots: checked via crawler-commons 1.4-SNAPSHOT (https://github.com/crawler-commons/crawler-commons)
format: WARC File Format 1.1
conformsTo: https://iipc.github.io/warc-specifications/specifications/warc-format/warc-1.1/