odewahn / dds-field-guide Goto Github PK

I'm not really sure where this should go, but figured an issue is as good of a place as any for now. What I'm wondering is what form non-tool contributions should take. Writing something up and then throwing it over the wall may not be ideal if there's significant effort in writing it up and it just gets turned down. Perhaps collecting a set of TODOs and suggested topics or areas needing additional elaboration would be helpful.

One thing I'd like to see (and would be happy to contribute to, if time permits) would be adding some example scenarios of how these tools might be used in practice. E.g., for the monitoring chapter, it would be good to describe a couple situations using some of the tools mentioned and how they might fit into an overall infrastructure/architecture following the "patterns" (using that term very loosely here) described in the book.

This guide is mostly focused on tools and technical practices, but there are a lot of aspects that go to business practices. Should there be a section for this?

For example, here are a few ideas:

• Building a DevOps culture
• Design and UX
• Non-Functional requirements is the competitive advantage (per @ragsns)

There are probably many, many others.

I think that saying that Twisted is a web framework is not false, but I think It's far away from what someone might expect.

Do not misunderstand me, I like Twisted, I made projects using Twisted in the past, but I guess target audience for this content is waiting for de-facto / most popular frameworks. I don't say Twisted for web dev is obscure, just that it's not the straightforward way nowadays.

See http://twistedmatrix.com/trac/wiki/WebDevelopmentWithTwisted for reference.

PS : I made this an issue to discuss it, because I was surprised when reading this. You can tell me that the more we have, the more exhaustive we are and that's fine :)

The "fork me on github" ribbon at http://sites.oreilly.com/odewahn/dds-field-guide/ is not clickable.

Item 2) of the "How to contribute" list works, though.