Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

Yip. rst is well supported on GitHub e.g. you can use README.rst in your projects rather than README.md which i didn't know until recently.

Makes including readme text in python packages for display on PyPI super convenient, in setup.py:

    """A silly setup.py example"""

    from setuptools import setup
    from os.path import dirname, join
    
    THIS_DIR = dirname(__name__)
    README = open(join(THIS_DIR, "README.rst")).read()
    
    setup(
        name ...,
        description=__doc__,  # """A silly setu...
        long_description=README
    )



Cool, i didn't know that! I always thought how much i would like to use rst instead of md, nice :)




Consider applying for YC's Fall 2025 batch! Applications are open till Aug 4

Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: