Contributing is easy, and we welcome your input. Contributions will typically in the form of corrections, or additions (new chapters.)
To make a contribution, please fork the repo, make your changes, and submit them as a pull request. We'll then review them and merge if appropriate. (You might get some comments/feedback on things to change to your submission. Please take these in the spirit in which they are intended - to make the end result a handy resource, and true to the spirit of the original posts.)
Thanks for your input!
To "port" a chapter I do the following:
- Cut and paste the Chapter post into a new Google Doc
- Set the title to be a "Title", and headings to be Heading 1, Heading 2, etc as appropriate
- Use the Asciidoc Processor Google Docs plugin to generate the AsciiDoc version of the document
- Copy the generated result, and paste it into a new .doc file
- Save the file with the name
chapter-N-CHAPTER-TITLE.adoc - Add the chapter anchor at the top (see existing chapters for what this looks like)
- Add newlines after every
+character - Download all the images from the chapter and put them in the "images" directory
- Replace every "Figure X ..." with the image title / link / anchor etc. (see existing chapters for what this looks like)
- Replace the links to other chapters / figures with
xrefs(cross-references) - Add the chapter to the spine file (
wardley-maps-book.adoc) - Remove the todo from the list below for the chapter you just ported