Skip to content

Documentation crosslinking #3719

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

Open
mindrones opened this issue Oct 16, 2019 · 3 comments
Open

Documentation crosslinking #3719

mindrones opened this issue Oct 16, 2019 · 3 comments
Assignees

Comments

@mindrones
Copy link
Member

mindrones commented Oct 16, 2019

Following this conversation I've started a spreadsheet to track down what parts of the API, the tutorial and the examples can eventually be interlinked [1].

Once we'll have figured out all the links we can figure out eventually how to add links in a non-intrusive/usable way in the site, depending on the links volume.

Assigning to myself but please feel free to get onboard and help as this seems quite a bit of work (we can use comments in the spreadsheet for ease of use).

The json files extracted from the site as of now are at [2].


These are the sections of the 3 types of doc, each having 2 columns on the right to add correspondences.

If a section in /docs has a correspondence in /tutorial we can add an "x" in the "Tut" column and link it to the correspondent cell under "Tutorial".

For example these cells are linked:

Screenshot 2019-10-16 at 12 41 43

If we'll find sections with multiple links we can add more "x cells", say for example like this:

Screenshot 2019-10-16 at 12 44 53

For ease of use:

  • Cmd-K to link it to some target cell
  • select the target cell or type in the target cell coordinate (E11)
  • save

[1] https://docs.google.com/spreadsheets/d/14bdp_XNm-n9opbymT_F1T7t0j9Edwl8NSK5G9gweiCU/edit#gid=0

[2] https://gist.github.com/mindrones/bac9331855f29476598ed274be330118

@mindrones
Copy link
Member Author

mindrones commented Oct 16, 2019

Quick note, updated the spreadsheet link as apparently it was the wrong one (sorry for the noise)

@mindrones mindrones changed the title Documentation interlinking Documentation crosslinking Oct 21, 2019
@mindrones mindrones added site and removed site: docs labels Jul 12, 2020
@stale
Copy link

stale bot commented Jun 27, 2021

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 stale bot added the stale-bot label Jun 27, 2021
@pngwn pngwn added documentation and removed site labels Jun 27, 2021
@stale stale bot removed the stale-bot label Jun 27, 2021
@stale
Copy link

stale bot commented Dec 28, 2021

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.

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

No branches or pull requests

3 participants