Skip to content

Symbols explainer post-workshop#323

Open
matatk wants to merge 16 commits into
mainfrom
symbols-explainer-post-workshop
Open

Symbols explainer post-workshop#323
matatk wants to merge 16 commits into
mainfrom
symbols-explainer-post-workshop

Conversation

@matatk
Copy link
Copy Markdown
Contributor

@matatk matatk commented Jul 22, 2025

@matatk
Copy link
Copy Markdown
Contributor Author

matatk commented Jul 22, 2025

Per the call, we want a hyperlink in the intro that demonstrates that people have been using the Bliss language for some time.

matatk added 3 commits July 22, 2025 15:34
Per the call, the three intro bullets should introduce the primary sections to come later, as equals. So no need to link to just one.
@matatk
Copy link
Copy Markdown
Contributor Author

matatk commented Jul 22, 2025

Some other notes from the call:

  • Need to decide whether the section on the registry should be part of this explainer or not - the plan was not but maybe it should be included? There is contradiction in the explainer as it is now.

  • Need to rename the explainer, as there's no 'Symbols Module' anymore.

@matatk matatk marked this pull request as ready for review September 9, 2025 12:41
@matatk
Copy link
Copy Markdown
Contributor Author

matatk commented Sep 9, 2025

I've made the couple of final tweaks we agreed, so I think it's time to mark this as ready for review, and merge it soon. The registry section does need better integration into the rest of the doc, and we have various other parts highlighted for further work, but merging this provides us with a good basis for those more focused additions/changes, which we could do in separate PRs.

Comment thread explainers/symbols.md Outdated
Comment thread explainers/symbols.md Outdated
Comment thread explainers/symbols.md Outdated
Comment thread explainers/symbols.md Outdated
Comment thread explainers/symbols.md Outdated
Delete line, no longer applicable.
Comment thread explainers/symbols.md Outdated
Comment thread explainers/symbols.md
We're working closely with BCI on this specification, and the W3C AAC Symbol Registry (more details below).
The W3C AAC Symbol Registry provides the code points used to identify a given concept.

* **Use of the `<ruby>` element for presentation&mdash;with a `lang=zbl` attribute to indicate this is a symbol.**
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* **Use of the `<ruby>` element for presentation&mdash;with a `lang=zbl` attribute to indicate this is a symbol.**
* **Use of the `<ruby>` element for presentation&mdash;with a [`lang=zbl`](https://www.loc.gov/standards/iso639-2/php/code_list.php) attribute to indicate this is a symbol.**

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.

Rewrite Symbols explainer introduction

3 participants