Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Bad link to UoM Guide hosting on GH repo page #6

Open
mikro2nd opened this issue Jan 21, 2021 · 2 comments
Open

Bad link to UoM Guide hosting on GH repo page #6

mikro2nd opened this issue Jan 21, 2021 · 2 comments

Comments

@mikro2nd
Copy link

mikro2nd commented Jan 21, 2021

The Github project page for the Guide at https://github.com/unitsofmeasurement/uom-guide points the unsuspecting and unwary noob to the published version of the guide at a link (https://www.gitbook.com/book/unitsofmeasurement/uom-guide/details) that frustratingly leads only to GitBooks insistent sales schpiel. For those of us way behind the curve on GitBook's unfriendly shenanigans, this leads, in turn, to a frustrating half-hour of searching around the Internet for the actual published content.

Might this link be updated to the correct one: https://unitsofmeasurement.gitbook.io/uom-guide/ thus saving the blood-pressure and time of millions of future users. ;)

Even better: might said content be hosted somewhere friendlier and more open than GitBook? I'm willing to assist if I can.

@keilw
Copy link
Member

keilw commented Jan 21, 2021

Judging from the downloads there are indeed Millions of users, but how many actual users would consume the guide I cannot say.
While Asciidoc was discussed and even given a try in other areas that does not seem a viable option or enthusiasticly picked up by "Millions" of eager editors either, so I would not go there unless you could demonstrate it offers the same reader experience especially with multi-language support like https://unitsofmeasurement.gitbook.io/uom-guide/advanced/advanced
(providing alternatives for Java or Kotlin, forget about the extent of the example, but I'm not aware of a quick and clean approach to that in Asciidoc)

We just migrated the TCK page in a similar way to a GH page, there are at least a dozen places, so let's keep an eye on it e.g. when doing something else like unitsofmeasurement/unit-tck-usage#32.

Thanks for spotting it, but unless Gitbook also charges authors (if they charge a moderate fee for reading it so be it, but currently it seems free or up to authors to charge for those books) like some other self-publishing solutions, I don't think it's worth the effort and Asciidoc is not really a comparable solution especially when you browse the document online.

@mikro2nd
Copy link
Author

Ja, ja. The alternative hosting suggestion was just an afterthought, really :) and not too seriously thought out. I agree that the cost/effort hardly justifies doing it. (Maybe.) The main thing is having a less circuitous way to find the content in the first place. :D

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants