[OpenStack-docs] OpenStack Liberty Docs PDF Version

Anne Gentle annegentle at justwriteclick.com
Mon Oct 19 13:22:18 UTC 2015


On Mon, Oct 19, 2015 at 8:18 AM, Matt Kassawara <mkassawara at gmail.com>
wrote:

> I don't like PDFs because people save/print them and assume the content
> never changes. For the installation guide and other procedural
> documentation in particular, this often leads to bug reports and support
> requests for items that were already addressed. One could also argue that
> PDFs slow our march toward EPPO, particularly the ability to easily bounce
> among documents.
>
>
People always ask for PDF, but I don't think we should prioritize it over
other work. There are plenty of reasons people prefer PDF, all good ones.
Let's document how to make your own and call it a day.

Anne


> On Mon, Oct 19, 2015 at 12:44 AM, Pančur, Matjaž <
> Matjaz.Pancur at fri.uni-lj.si> wrote:
>
>> My experience is the similar as Matt’s (e.g. I often get asked about PDFs
>> of everything I present). Same goes for the slides (in the context of the
>> Training guides)) - some students really like to have slides printed in
>> advance and they scribe their notes on them.
>>
>> Matjaz
>>
>>
>>
>> On 19 Oct 2015, at 07:33, Matthew Dorn <madorn at gmail.com> wrote:
>>
>> Here at Rackspace Training,  we are really missing the PDF's!
>>
>> In the past, we always copied to our e-readers/tablets to review while
>> traveling.
>>
>> I've had students ask about it as well.
>>
>> Matt
>>
>> On Mon, Oct 19, 2015 at 12:24 AM, Lana Brindley <
>> openstack at lanabrindley.com> wrote:
>>
>>> -----BEGIN PGP SIGNED MESSAGE-----
>>> Hash: SHA256
>>>
>>> On 19/10/15 15:21, Andreas Jaeger wrote:
>>> > On 10/18/2015 11:59 PM, Lana Brindley wrote:
>>> >> -----BEGIN PGP SIGNED MESSAGE-----
>>> >> Hash: SHA256
>>> >>
>>> >> On 17/10/15 04:55, Roozbeh Shafiee wrote:
>>> >>> Hi folks,
>>> >>>
>>> >>> I’m trying to download the PDF version of OpenStack Liberty
>>> documentations. It seems some of them updated and the download link has
>>> removed.
>>> >>> How can I find and download the PDFs?
>>> >>
>>> >> For the newer RST books, we do not publish PDF versions, as Sphinx is
>>> not capable of producing them.
>>> >
>>> > Sphinx can produce PDFs but we need to figure out how to best do it -
>>> and whether we need to enable it at all,
>>> >
>>>
>>> Oh, good to know. This is only the second request I've ever seen, so I'm
>>> not certain there's a huge demand. Unless Anne or others have seen a
>>> barrage of requests?
>>>
>>> L
>>>
>>> - --
>>> Lana Brindley
>>> Technical Writer
>>> Rackspace Cloud Builders Australia
>>> http://lanabrindley.com
>>> -----BEGIN PGP SIGNATURE-----
>>> Version: GnuPG v2
>>> Comment: Using GnuPG with Thunderbird - http://www.enigmail.net/
>>>
>>> iQEcBAEBCAAGBQJWJH6kAAoJELppzVb4+KUyQo0IALkrH2m7Ig2YrtmXaD6YPbfW
>>> sQ5jZ5M11wxb7w2t/z+KiNLt2c4f4eTvm1qPPh2cjIrM6cMAm1oFrPnodKN/imm/
>>> Q0wC/8p9ymAZpd2D0D89OKk2Dip1TJ5kHPf6/wU5kkxG7ITX/jfB7CEa8ts1qylm
>>> H8jKhpGobS50/t7nXgul10+pMSGJ4rmlN8pR6JmTCZm3GayCMCYAVeUubbkpYP/v
>>> XjAvt1Xtr3tuCpzeAmvnvwJLfSNq2+Z5czYvkv22PG6qFXiTzc0NnXS5FnyLq0ZV
>>> xx2hhFqbsbHbU97qoJOcamyQ+NIBFi4hoPOlJirXXdMJO7mgKmcTmdLdJb/OSKo=
>>> =TFDa
>>> -----END PGP SIGNATURE-----
>>>
>>> _______________________________________________
>>> OpenStack-docs mailing list
>>> OpenStack-docs at lists.openstack.org
>>> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
>>>
>>
>> _______________________________________________
>> OpenStack-docs mailing list
>> OpenStack-docs at lists.openstack.org
>> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
>>
>>
>>
>> _______________________________________________
>> OpenStack-docs mailing list
>> OpenStack-docs at lists.openstack.org
>> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
>>
>>
>
> _______________________________________________
> OpenStack-docs mailing list
> OpenStack-docs at lists.openstack.org
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
>
>


-- 
Anne Gentle
Rackspace
Principal Engineer
www.justwriteclick.com
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20151019/834d4a22/attachment.html>


More information about the OpenStack-docs mailing list