Skip to content

Conversation

l-zeuch
Copy link
Collaborator

@l-zeuch l-zeuch commented Jan 17, 2025

Clean up the Syntax and Data page.

This PR will probably amass a rather large amount of commits, due to its
sheer size. I'll try to keep each individual commit's diff reasonably
small, starting with some cleaning of Gitbook's generated markdown.

To outline some of the changes I'll be making:

  • Some paragraphs are repeated verbatim -- remove / rephrase duplicates.
  • Some sections are far too verbose for an "overview" page -- shorten
    them, and/or move them to learn instead.
  • Certain field descriptions could be more concise; opt for supplemental
    paragraphs below the table instead.
  • Rewrite some data types to be more consistent with the already
    established terms in the learn section. There isn't a lot of reason
    to list the bot's internally used data types.

If you feel like submitting additional patches, please do so (raise them
against this branch). I'd greatly appreciate any work I do not have to
do myself.

Terms

@l-zeuch l-zeuch force-pushed the cleanup/syntax-and-data branch 3 times, most recently from 36123cd to 5b62757 Compare January 17, 2025 18:20
@l-zeuch l-zeuch force-pushed the cleanup/syntax-and-data branch from 5b62757 to 5203c43 Compare August 25, 2025 12:17
@l-zeuch
Copy link
Collaborator Author

l-zeuch commented Aug 25, 2025

This has been sitting around far too long; I'll close this for the time being and maybe start over whenever I find the time.

@l-zeuch l-zeuch closed this Aug 25, 2025
@l-zeuch l-zeuch deleted the cleanup/syntax-and-data branch August 25, 2025 12:19
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

Successfully merging this pull request may close these issues.

1 participant