ts-toolbelt icon indicating copy to clipboard operation
ts-toolbelt copied to clipboard

feat(docs): one click "add example" button

Open mesqueeb opened this issue 5 years ago • 7 comments

🍩 Feature Request

Teachability, Documentation, Adoption, Migration Strategy

In the documentation, there is often a case where I find the example lacking and would like to suggest a new example or add one where there is none.

Currently there's a link like so: image

However, the problem is that this opens the page at a specific blob like this link: https://github.com/millsp/ts-toolbelt/blob/3859d18/src/Any/Compute.ts#L48

From here it's pretty complicated how I can easily make a change and open a PR.

With other sites that use eg. Vue Press, you'll get this "edit these docs" link like so:


Screenshot 2020-09-14 at 19 12 47
Which, if you don't have a fork, will automatically create a fork and prompt to open a PR after a change.

Maybe you could slightly make this adjustment to the links you added to your examples so it does the same?

mesqueeb avatar Sep 14 '20 10:09 mesqueeb

Definitely! I was needing to move the website to .md files but I got too busy lately. I though I'd move to docz but I'm not sure if they have such a feature for editing. Don't hesitate to share a list of doc generators you like.

millsp avatar Sep 14 '20 11:09 millsp

Thanks for your help

millsp avatar Sep 14 '20 11:09 millsp

Well, I like Vue Press, but I know you're a React guy, so we're kinda in different camps here 😛

mesqueeb avatar Sep 14 '20 11:09 mesqueeb

Yeah, for us react guys there's docusaurus :t-rex:

millsp avatar Sep 14 '20 11:09 millsp

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.

stale[bot] avatar Nov 14 '20 08:11 stale[bot]

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.

stale[bot] avatar Mar 19 '21 23:03 stale[bot]

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.

stale[bot] avatar Jul 30 '21 04:07 stale[bot]