Jean Abou Samra

I like the simplification of the sidebar. Would it not be better to move reST files around instead of using `../`, even if we need to add redirects? I was...

Also, I'm not sure "Reference" is the best place for the "News" page. Perhaps make an "About" folder for "News" and "Contributing"?

In that case, maybe we should just orphan the page?

> I personally am more comfortable with the authors describing their work "human-readable" / in detail themselves. I'm not sure what exactly you mean by this, but I'd be wary...

@illume Can you elaborate please?

Ah, maybe. But then, this is really dependent on the build backend. I think this should be left to individual backend docs since it will tend to get outdated if...

Ok, good idea. > Explain how to choose if files belong in sdist or wheel or both. A tricky question since there is, AFAIK, no consensus on that. https://discuss.python.org/t/should-sdists-include-docs-and-tests/14578 https://discuss.python.org/t/sdists-for-pure-python-projects/25191/39

You'd put the image in some permanent location, e.g., inside your repository, and link it with standard Markdown or reST syntax in your `README.md` / `README.rst`, e.g., ``.

> What works on Pypi? I just did a test here: https://test.pypi.org/project/readme-rendering-test-jeanas/ Package source: [readme-rendering-test-jeanas.zip](https://github.com/pypa/packaging.python.org/files/13955664/readme-rendering-test-jeanas.zip) It appears that: - PyPI supports external image URLs - PyPI does not support local...

> Personally I believe READMEs should contain only text. If I were to want to show screenshots, then I would put these screenshots on a separate website It can be...