Citing and References

[obstschale]

Do you have any intention how to cite in this book. I think a bibliography with a Harvard Style is not needed but it would be good to give some links and sources which are used for a chapter. So the reader can get more information if needed.

Two simple possibilities are in my mind:

1. Just use one markdown file at the end of the book an list all references ordered by chapter
2. add a section to the end of each chapter for Further Reading

I personally like the second one, because if I read a chapter and have some questions I have all links at my fingertips and don't have to check the references page.

[tomjn]

Further reading sections sounds like a good idea, though I'm generally linking out on the references with inline hyperlinks

[obstschale]

Sure, if I mention something in the text, like I did with VagrantPress, I just link it. But for example I know a great article about Debugging. It would not mention that article directly rather set a link in the Further Reading section.

[wycks]

Mozilla does this nicely , for example https://developer.mozilla.org/en-US/docs/Web/JavaScript/Introduction_to_Object-Oriented_JavaScript you can see linked "read more sections" , it's actually not a blockquote but just a div called "note" with specific styling.

[obstschale]

You can use HTML in markdown but I don't think that is a good idea to introduce custom stylings. We should stick to the simple Markdown.

Although it looks nice ;)