Update documentation including instructions on how to make a new release

README.rst

@@ -213,3 +213,18 @@ Hoje nos arquivos CSS existem regras para mostrar links de línguas,
 como as classes ``language-en`` e ``language-es``.
 Para adicionar links dessas línguas sem precisar customizar o tema,
 adicione em ``site_actions`` actions com esse mesmo id e as regras do Diazo pegarão os links renderizados das actions posicionando corretamente na lista de línguas no tema.
+
+Fazendo releases com o zest.releaser
+------------------------------------
+
+Os recursos estáticos do pacote são gerados usando o `webpack <https://webpack.js.org/>`_ e não são inclusos no VCS.
+Se você está fazendo release usando o zest.releaser, você precisa fazer `upload manual dos arquivos no PyPI <https://github.com/zestsoftware/zest.releaser/issues/261>`_ ou você vai criar uma distribuição quebrada:
+
+* execute ``longtest`` e ``fullrelease``, como de costume
+* responda "não" para evitar o upload ao PyPI e continue normalmente
+* faça checkout na tag do release que você está liberando
+* execute ``bin/build-brasilgovtemas`` para criar os recursos estáticos
+* crie os arquivos da distribuição usando ``python setup.py sdist bdist_wheel``, como de costume
+* faça o upload manual dos arquivos usando ``twine upload dist/*``
+
+Caso de erro você terá que criar um novo release pois o PyPI Warehouse `não permite reutilizar um nome de arquivo <https://upload.pypi.org/help/#file-name-reuse>`_.