steem-python icon indicating copy to clipboard operation
steem-python copied to clipboard

steem.readthedocs.io does not reference this repo

Open theoreticalbts opened this issue 7 years ago • 7 comments

I started reading the docs, on http://steem.readthedocs.io/ as suggested by README.md. That site says:

"steem-python is the official STEEM library for Python. It comes with a BIP38 encrypted wallet and a practical CLI utility called stemepy."

I wanted to submit a PR to change the typo stemepy, but I found (by clicking on the "Edit on GitHub" link) that the readthedocs site references the Netherdrake repo.

I propose one of the following two solutions:

  • (a) Change the readthedocs setup to point the steem.readthedocs.io URL to documentation generated from this repo (steemit/steem-python) instead of netherdrake/steem-python.
  • (b) If solution (a) is not possible, create a new documentation hosting URL for this repo (on readthedocs or otherwise). Then change the README.md in this repo to point to that URL.

theoreticalbts avatar Sep 25 '17 22:09 theoreticalbts

I've offered to give away the steem.readthedocs.io namespace a few months ago, and the offer is still open. @sneak if you want it, just ping me @ anytime.

Netherdrake avatar Sep 25 '17 22:09 Netherdrake

We don't want to use that site/URL. Please delete it. The authoritative documentation for steem-js and steem-python will be located within their respective repos, and will be extracted, hosted, and displayed on our devportal.

//cc @goldibex

sneak avatar Sep 25 '17 22:09 sneak

I use the steem.readthedocs.io site all the time for reference, don't delete it until you've got something else up IMO. There are likely many more like myself who use it.

aaroncox avatar Sep 26 '17 06:09 aaroncox

I don't want to infringe on Steem's name, or confuse people about where the official documentation is. At the same time, current documentation is in use by people.

I'm looking forward to guidance on what should I do.

Netherdrake avatar Sep 26 '17 14:09 Netherdrake

As soon as our devportal's up (with the same docs from the repo), please feel free to kill off the RTD site if you wish. You're not infringing anything by hosting MIT-licensed docs there - but they will eventually get out of date and our canonical docs will be at the devportal.

sneak avatar Oct 01 '17 18:10 sneak

When the devportal has the Python docs, I will deprecate the package and refer to steemit/steem-python and devportal.

Netherdrake avatar Oct 01 '17 19:10 Netherdrake

Our devportal still links to the RTD site. We need this switched.

cyon1c avatar Mar 07 '18 19:03 cyon1c