Static page community examples links still point at janetdocs.com

[sogaiu]

This issue is a follow-up to this comment regarding updating the static files for previous Janet versions.

---

Subsequent to the merging of #304, community example links for the latest docs now point at janetdocs.org instead of janetdocs.com. However, as noted in the PR, similar links in the static pages have not been updated and still point at janetdocs.com.

This doesn't seem like an urgent issue, but if it's doable to change these links it might be less confusing (and eventually prevent 404-ing).

---

A cursory review suggests that there are community examples links among the core api, jpm, and spork pages for certain Janet versions:

• core api - the pages for versions 1.10.1 through 1.37.1 (inclusive) have community example links pointing at janetdocs.com, e.g. at:

  • https://janet-lang.org/1.10.1/api/index.html
  • https://janet-lang.org/1.37.1/api/index.html

• jpm and spork - the pages for versions 1.25.1 through 1.34.0 (inclusive) have community example links pointing at janetdocs.com, e.g. at:

  • https://janet-lang.org/1.25.1/api/jpm/rules.html
  • https://janet-lang.org/1.34.0/api/jpm/rules.html
  • https://janet-lang.org/1.25.1/api/spork/index.html
  • https://janet-lang.org/1.34.0/api/spork/index.html

---

AFAIU, the older janetdocs (janetdocs.com) never had support for things like jpm or spork, so I think we might as well remove the existing community example links for the versions mentioned above (i.e. 1.25.1 through 1.34.0).

---

For core api callables, below are a couple of examples of what to change:

• no prefix in name

  • old: https://janetdocs.com/%
  • new: https://janetdocs.org/core-api/%25

• prefix in name

  • old: https://janetdocs.com/tuple/brackets
  • new: https://janetdocs.org/core-api/tuple%2fbrackets

Not sure if this is a comprehensive description of URL changes [1]. Feedback welcome.

---

[1] Possibly relevant source lines might be:

• part of emit-item
• jdoc-escape
• url-repl-chars

[bakpakin]

The static pages are, to me, somewhat like an archive (I don't go back and fix erata) but in this case I agree we should update them.

[sogaiu]

Thanks for the feedback.

I've started work on the link removal portion as it seems to me that getting that part done first may make the rest easier.