SpecialistOff.NET / Вопросы / Статьи / Фрагменты кода / Резюме / Метки / Помощь / Файлы

Don’t Get Attached

Метки: python

Writing is rewriting. Your stuff will get rewritten, probably multiple times. This makes it better for the reader. It doesn’t mean it was bad. Everything can be made better.

By the same measure, don’t worry if your examples or prose aren’t perfect. Don’t let that keep you from contributing them early. They’ll get rewritten anyway, so don’t worry too much – do the best you can, but don’t get blocked.

There’s also an editor who will be rewriting for clarity and active voice. He doesn’t necessarily understand the technology but he will still be able to improve the flow. If you discover he has introduced technical errors in the prose, then feel free to fix it but try to maintain any clarity that he has added.

If something is moved to Volume 2 or the electronic-only appendices, it’s just a decision about the material, not about you.