npm package missing readme

[brian-smith-tcril]

[brian-smith-tcril]

From what I've read it seems like npm might not support .rst readmes. Maybe we can generate a .md that links to the GH repo?

[OmarIthawi]

I think it's a package.json configuration issue. I'll publish to pypi and get back to this.

[OmarIthawi]

@brian-smith-tcril Based on my quick research, it looks like that npm doesn't support RST at all, while PyPi appears to support both RST and Markdown:

• https://docs.npmjs.com/about-package-readme-files
• https://packaging.python.org/en/latest/guides/making-a-pypi-friendly-readme/

Popular packages such as React.js use Markdown: https://www.npmjs.com/package/react

Some Open edX packages uses Markdown as well such https://www.npmjs.com/package/@edx/paragon while others don't as you pointed out for frontend-build.

We have a couple of options:

1. Use Markdown on all Open edX Nodej.s packages
2. Use Placeholder README (my least favorite)
3. Convert to Markdown on the fly (adds yet one more build step)

I'm leaning towards using Markdown at least until npmjs has support for RST.

[brian-smith-tcril]

@OmarIthawi would you mind adding that comment to openedx/public-engineering#215 ? I brought this up in standup yesterday and people seemed to be OK with the placeholder idea, but I'm more than happy to re-open the discussion.