Opened 8 years ago

Last modified 5 years ago

#4155 enhancement new

Write an introduction for the core howto docs

Reported by: Jean-Paul Calderone Owned by:
Priority: normal Milestone:
Component: core Keywords: documentation
Cc: Thijs Triemstra Branch:


The core docs start off with three "introductory" documents. The vision statement, the "overview", and the "internet overview". These are all rather out of date and are pretty short on the sort of material which usually appears in the introduction to an unusual, expansive system such as Twisted. Specifically, the introduction should address:

  • What Twisted is good for
  • A high-level overview of how Twisted works
  • How the documentation is laid out (inasmuch as it follows any sensible layout, which unfortunately isn't very much), including the split between api docs, howto docs, and examples

And (so that I can resolve #4136) there should also be a mention of where the latest version of the documentation can be found.

Change History (3)

comment:1 Changed 8 years ago by khorn

This blog series has some great information that could possibly be adapted to this purpose.

comment:2 Changed 7 years ago by <automation>

Owner: Glyph deleted

comment:3 Changed 5 years ago by Thijs Triemstra

Cc: Thijs Triemstra added
Note: See TracTickets for help on using tickets.