Opened 16 years ago

Closed 17 months ago

Last modified 17 months ago

#1830 task closed wontfix (wontfix)

Sell the Twisted reference PDF, bound as a physical book

Reported by: Jean-Paul Calderone Owned by:
Priority: highest Milestone:
Component: core Keywords: documentation
Cc: Thijs Triemstra, khorn Branch: branches/pdf-bound-documentation-1830-4
branch-diff, diff-cov, branch-cov, buildbot
Author: exarkun

Description

  • Remove obvious garbage from the pdf
  • Find an on-demand publishing site
  • Do it
  • Fold appropriate improvements from the published pdf back into the regular pdf

Change History (16)

comment:1 Changed 16 years ago by Glyph

Summary: Sell the Twisted bookSell the Twisted reference PDF, bound as a physical book

Made the subject clearer so that people don't think this ticket is related to O'Reilly's Twisted book.

comment:2 Changed 16 years ago by itamarst

Status: newassigned

We also need to add list of authors and license.

We will use lulu.com for the first run.

comment:3 Changed 15 years ago by itamarst

We're going to use regular PDF.

License by itself should be sufficient, since it lists Twisted Matrix Labs.

Saph has made some cover images.

comment:4 Changed 15 years ago by itamarst

JP, could you take a look at the branch?

Also, I'm considering dropping the finger tutorial so this is more of a reference (and a lot shorter, thus cheaper to print). Any thoughts?

comment:5 Changed 15 years ago by itamarst

Keywords: review added
Owner: itamarst deleted
Status: assignednew

Changes are in /branches/pdf-bound-documentation-1830-3 - I removed some bogus howtos, re-organized the PDF, added license, and made output look better.

comment:6 Changed 15 years ago by Jean-Paul Calderone

Priority: highhighest

comment:7 Changed 15 years ago by Jonathan Lange

Syntactically the code changes look fine.

admin/process-docs fails for me, but I think that's because I am missing some dependencies. A bug should be filed to catch this.

It would be good to have a parameter for paper size, but I don't think that should block this branch.

The content and layout of the book still need to be reviewed.

comment:8 Changed 15 years ago by Jean-Paul Calderone

Keywords: review removed
Owner: set to itamarst

Some things I notice in book.pdf (some of these are changes in the branch, some are problems in trunk):

  • There is now a blank page between the title page and the table of contents page. There was not one before.
  • The table of contents used to be page 1, now it is page 3
  • Page numbers are now book-style (although evens are on the left and odds are on the right, which seems wrong if the title page is page 1, but maybe that's what the blank page is for? still, I think evens should be on the right.)
  • More space between table of contents lines
  • Even though we removed content, I see that the book is longer now - 233 pages in current trunk@HEAD, 241 in the branch.
  • I think we can probably afford to leave out the dirdbm content (if this is contentious, disregard).
  • TwistedQuotes still uses the old plugin system :(
  • Section 1.1 misspells "concepts" as "conepts" - this is from async.xhtml. Should we spellcheck the whole thing, maybe? :)
  • Section 6.4, Using telnet to manipulate a twisted server, uses the deprecated telnet support.
  • The LICENSE file says copyright 2001-2006

I think I'll stop there. I don't think we need to make everything across all of our documentation perfect in order to bind and sell it (would that we had the resources to do so). I do think it would be beneficial to have a preface written specifically for the printed version, though.

comment:9 Changed 15 years ago by Jean-Paul Calderone

FWIW, for anyone who can't actually generate the pdf, versions based on trunk and the branch can be found (at least for a while) here:

http://twistedmatrix.com/~exarkun/book-aug-18-2007-trunk.pdf http://twistedmatrix.com/~exarkun/book-aug-18-2007-branch.pdf

comment:10 Changed 14 years ago by collab

Cc: collab added

comment:11 Changed 14 years ago by Thijs Triemstra

Cc: Thijs Triemstra added; collab removed

comment:12 Changed 13 years ago by Jean-Paul Calderone

Author: exarkun
Branch: branches/pdf-bound-documentation-1830-4

(In [27416]) Branching to 'pdf-bound-documentation-1830-4'

comment:13 Changed 12 years ago by Thijs Triemstra

Cc: khorn added

comment:14 Changed 11 years ago by <automation>

Owner: itamarst deleted

comment:15 Changed 17 months ago by Adi Roiban

Resolution: wontfix
Status: newclosed

No plan to sell the book for now :)

comment:16 Changed 17 months ago by Glyph

Thanks for the ticket clean-up :)

Note: See TracTickets for help on using tickets.