Skip to content

Latest commit

 

History

History
36 lines (24 loc) · 2.83 KB

advanced-contribution-topics.md

File metadata and controls

36 lines (24 loc) · 2.83 KB

Translation / Lectorate

Althought most of the authors are not native English speakers, there is currently no translation service or lectorate foreseen.

Table of Contents

The Table Of Contents is in the /SUMMARY.md file. Feel free to adjust it, otherwise a Lead Author will do this for you.

Pictures

Including pictures is not yet set up.

Resources

To provide resources like links or books, create a second *.md file and name it like your article file including a ".resources". Example: The resources file for "my-funny-article.md" is "my-funny-article.resources.md".

Zühlke Github Community

To becoma properly registered as a public member of the "Zühlke Github Community":

Oppinionated Articles and Controversial Discussions

If you find an article in progress too opinionated or controversial, then ...

  • Do not forget this is an open community and that we should respect all other oppinions and be open for discussion about our ideas with each other in a resspectful kind. This is also what we want to advertise in this book, that we as Zühlke are open for our colleagues ideas and opinions and value each other, even in controversial discussions.
  • Do not hesitate to contact the author and discuss with him (e.g. on the issue of the article or for more controversial discussions maybe better face to face or via non-public communication channels)
  • Do not forget that the original author was maybe writing the article with another context in mind.
  • Consider to plan and write a counter article to pick up the point where you disagree with the original article or add your own view or aspect concerning that topic.
  • We motivate to also write about controversial topics and in some cases it might even make sense to have two articles, one with the arguments pro, another with the arguments contra. See also following example: in the book "Lessons Learned in Software Testing" there are two articles, one that recommends using the "IEEE-829-Standard" and right on the next page there is the next article that recommends to not use this standard (this was mentioned in https://www.heise.de/developer/artikel/Neuer-Test-Standard-ISO-29119-pro-und-contra-2429610.html).
  • If you can not agree on a topic and there is a conflict that you think needs some help with resolution, you can contact the Lead Authors, they will try to moderate in the conflict situation and help you to decide how to proceed with the article(s) in question.
  • Also relax and bare in mind that not all articles might find place in a printed edition of this collection.