Add example for spork/argparse/argparse

[brendanhowell]

I am a janet noob so please let me know if I should change anything style-wise.

[sogaiu]

Thanks for your contribution.

I've tried the code and it seems to work 👍

Below are some general concerns that this PR has surfaced -- I don't think they are points about the content of this PR.

---

IIUC, this is the first instance of examples for spork and I'm not sure how we want to handle them. Some concerns might be:

• Do we really want spork examples to live in the same directory as those for janet itself?
• Do we want the examples to live in the janet-lang.org repository? May be the answer is "yes".
• This PR may result in some changes to how things are arranged. Are there any factors we should consider related to that?

---

One thing I noticed is that although the examples show up on the overall spork page at:

http://localhost:8000/api/spork/index.html#spork/argparse/argparse

they don't seem to show up on the page for spork/argparse at the appropriate spot:

http://localhost:8000/api/spork/argparse.html

Update: URLs were originally swapped in error, but should now be correct.

Note that a similar thing does not appear to hold for some janet core items. For example, string/split appears on both the overall page for core items as well as on the String Module page.

[brendanhowell]

IIUC, this is the first instance of examples for spork and I'm not sure how we want to handle them. Some concerns might be:

* Do we really want spork examples to live in the same directory as those for janet itself?

* Do we want the examples to live in the janet-lang.org repository?  May be the answer is "yes".

* [This PR](https://github.com/janet-lang/janet-lang.org/pull/230) may result in some changes to how things are arranged.  Are there any factors we should consider related to that?

Hmm… I was wondering some of the same things. The proposed PR sounds quite sensible to me. But it looks like it needs a little work. I'm happy to move my example to fit the new organization. Maybe we can leave this open and I will adjust once things get merged.

One thing I noticed is that although the examples show up on the overall spork page at:

http://localhost:8000/api/spork/argparse.html

they don't seem to show up on the page for spork/argparse at the appropriate spot:

http://localhost:8000/api/spork/index.html#spork/argparse/argparse

Note that a similar thing does not appear to hold for some janet core items. For example, string/split appears on both the overall page for core items as well as on the String Module page.

I now see that I actually have the opposite problem but maybe that's what you meant. I can see my example on the overall spork page but not on the sub-page for argparse. Should I file a bug or just wait to see how things look after the re-organization?

[sogaiu]

Maybe we can leave this open and I will adjust once things get merged.

Why don't we go with this for the moment.

I now see that I actually have the opposite problem but maybe that's what you meant. I can see my example on the overall spork page but not on the sub-page for argparse.

Sorry I got the URLs mixed up (^^;

I haved edited my post above to fix it.

Should I file a bug or just wait to see how things look after the re-organization?

If you don't mind doing it please file an issue. I think having an issue for it separately might make it easier to track as well as adjust for if necessary since it's unknown when the re-organization will take place.

[brendanhowell]

Relevant bug report #282