laforge has uploaded this change for review. ( https://gerrit.osmocom.org/c/pysim/+/33248 ) Change subject: README: remove redundancy 'Manual' and 'Documentation ...................................................................... README: remove redundancy 'Manual' and 'Documentation Also, re-order sections oriented more towards the user (Docs first) Change-Id: I4fc76222a1c22685131cb6926721ce24f0373046 --- M README.md 1 file changed, 44 insertions(+), 32 deletions(-) git pull ssh://gerrit.osmocom.org:29418/pysim refs/changes/48/33248/1 diff --git a/README.md b/README.md index 86dc63d..2a89c9a 100644 --- a/README.md +++ b/README.md @@ -22,10 +22,40 @@ that network. -Homepage and Manual -------------------- +Homepage +-------- -Please visit the [official homepage](https://osmocom.org/projects/pysim/wiki) for usage instructions, manual and examples. The user manual can also be built locally from this source code by ``cd docs && make html latexpdf`` for HTML and PDF format, respectively. +Please visit the [official homepage](https://osmocom.org/projects/pysim/wiki) +for usage instructions, manual and examples. + + +Documentation +------------- + +The pySim user manual can be built from this very source code by means +of sphinx (with sphinxcontrib-napoleon and sphinx-argparse). See the +Makefile in the 'docs' directory. + +A pre-rendered HTML user manual of the current pySim 'git master' is +available from <https://downloads.osmocom.org/docs/latest/pysim/> and +a downloadable PDF version is published at +<https://downloads.osmocom.org/docs/latest/osmopysim-usermanual.pdf>. + +A slightly dated video presentation about pySim-shell can be found at +<https://media.ccc.de/v/osmodevcall-20210409-laforge-pysim-shell>. + + +pySim-shell vs. legacy tools +---------------------------- + +While you will find a lot of online resources still describing the use of +pySim-prog.py and pySim-read.py, those tools are considered legacy by +now and have by far been superseded by the much more capable +pySim-shell. We strongly encourage users to adopt pySim-shell, unless +they have very specific requirements like batch programming of large +quantities of cards, which is about the only remaining use case for the +legacy tools. + Git Repository -------------- @@ -111,32 +141,3 @@ We are using a gerrit-based patch review process explained at <https://osmocom.org/projects/cellular-infrastructure/wiki/Gerrit> - - -Documentation -------------- - -The pySim user manual can be built from this very source code by means -of sphinx (with sphinxcontrib-napoleon and sphinx-argparse). See the -Makefile in the 'docs' directory. - -A pre-rendered HTML user manual of the current pySim 'git master' is -available from <https://downloads.osmocom.org/docs/latest/pysim/> and -a downloadable PDF version is published at -<https://downloads.osmocom.org/docs/latest/osmopysim-usermanual.pdf>. - -A slightly dated video presentation about pySim-shell can be found at -<https://media.ccc.de/v/osmodevcall-20210409-laforge-pysim-shell>. - - -pySim-shell vs. legacy tools ----------------------------- - -While you will find a lot of online resources still describing the use of -pySim-prog.py and pySim-read.py, those tools are considered legacy by -now and have by far been superseded by the much more capable -pySim-shell. We strongly encourage users to adopt pySim-shell, unless -they have very specific requirements like batch programming of large -quantities of cards, which is about the only remaining use case for the -legacy tools. - -- To view, visit https://gerrit.osmocom.org/c/pysim/+/33248 To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings Gerrit-Project: pysim Gerrit-Branch: master Gerrit-Change-Id: I4fc76222a1c22685131cb6926721ce24f0373046 Gerrit-Change-Number: 33248 Gerrit-PatchSet: 1 Gerrit-Owner: laforge <laforge@osmocom.org> Gerrit-MessageType: newchange