diff options
| author | Leitwolf11 | 2026-10-12 06:16:43 +0300 |
|---|---|---|
| committer | Leitwolf11 | 2026-10-12 06:16:43 +0300 |
| commit | 1bb833c4b98f5cd7343ae7b227c0fc39ee44deca (patch) | |
| tree | 8c65807b93471447db7d448ca67718bdcbb177c4 /Documents | |
| parent | 323eafd81177368657df2e219fbe239b97f9ccfd (diff) | |
| download | website-fix/tala-names-in-docs-and-api.tar.gz | |
Call the language Tala in the API, the documents and the templatesfix/tala-names-in-docs-and-api
The pages were renamed; the rest of the repository still said Visual X#:
- the site API answered with the name Visual X#, and its test expected it;
- the documents, the issue and pull request templates, the support address
and the name of the code scanning configuration.
The documents also said that a left-to-right mark follows the name of the
language in Hebrew text. That was for the `#` of the old name; the sentence
now speaks of names that end in a symbol, such as C#.
Not changed: host names, paths and unit names on the server, the name of the
backend artifact, the Kotlin package of the backend, and the keys of the
browser storage.
Diffstat (limited to 'Documents')
| -rw-r--r-- | Documents/CONTENT.md | 20 | ||||
| -rw-r--r-- | Documents/LOCALIZATION.md | 2 | ||||
| -rw-r--r-- | Documents/OPERATIONS.md | 8 | ||||
| -rw-r--r-- | Documents/README.md | 2 |
4 files changed, 16 insertions, 16 deletions
diff --git a/Documents/CONTENT.md b/Documents/CONTENT.md index 031ff1d..9c4eaab 100644 --- a/Documents/CONTENT.md +++ b/Documents/CONTENT.md @@ -3,7 +3,7 @@ # Language-site content contract -The site is an introduction to Visual X#, not the authority for every detail +The site is an introduction to Tala, not the authority for every detail of the language and not a release-coverage database. This document records the content decisions reviewers should preserve when improving the pages. @@ -12,7 +12,7 @@ the content decisions reviewers should preserve when improving the pages. The homepage should answer three questions before asking the reader to install anything: -1. What is Visual X# trying to make easier to reason about? +1. What is Tala trying to make easier to reason about? 2. What makes that direction different enough to investigate? 3. What can I inspect or try today without assuming the project is finished? @@ -40,7 +40,7 @@ the intended rule and the current limitation separately. If an example is only a design example, avoid presenting it as a verified runnable tutorial. The HelloWorld block on the site is copied from -`Examples/HelloWorld/HelloWorld.vxs`. When that file changes, update the +`Examples/HelloWorld/HelloWorld.tala`. When that file changes, update the website example and the tests together. A program entry is a class method, not a top-level function. Do not invent source syntax for a visual flourish. @@ -49,7 +49,7 @@ not a top-level function. Do not invent source syntax for a visual flourish. ### Home The hero introduces the project in one sentence and links to getting -started. The principles section answers “Why Visual X#?” without requiring +started. The principles section answers “Why Tala?” without requiring the reader to know internal intermediate-representation names. The source block is small on purpose. The current-state section distinguishes the language contract, compiler implementation, and ongoing work. It should @@ -86,7 +86,7 @@ development host based on incidental compatibility. The guide may mention package managers only for installing development tools. A developer installing LLVM through a package manager is not the -same thing as the Visual X# package service. There is no site-owned package +same thing as the Tala package service. There is no site-owned package management flow to link from this guide. ### Forum placeholder @@ -102,7 +102,7 @@ both in HTML and at the server boundary. `en-US` is the fallback and must carry complete content. `de-DE`, `ru-RU` and `he-IL` should express the same meaning, not mechanically mirror sentence -length. Keep technical spellings such as `Visual.XSharp.kts`, `CorePrep`, +length. Keep technical spellings such as `BUILD.kts`, `CorePrep`, `Xpp`, and `Xmm` stable. Translate navigation labels, help text, figure descriptions, and accessible names. When adding a paragraph or an interaction, add every language in the same change so a locale switch never @@ -115,7 +115,7 @@ settled term exists, keep the English term in Latin letters. Avoid forms of address that assume the reader's gender. Hebrew text runs right to left, and the page layout does not mirror. Follow -`Visual X#` and `C#` with a left-to-right mark in Hebrew strings so the `#` +a name that ends in a symbol, such as `C#`, with a left-to-right mark in Hebrew strings so the `#` stays with the name. [Localization](LOCALIZATION.md) describes the mechanics and how a page picks its language. @@ -132,12 +132,12 @@ parameters. The logo contains a leopard. Treat the leopard as an intentional mascot, not a decorative abstract flourish to be replaced by a generic X. Use the -full Visual X# composition where it is large enough to read; use the +full Tala composition where it is large enough to read; use the leopard-only vector crop for small browser and header contexts. It is acceptable for the SVG background to be transparent on the webpage while the social-preview image has a dark background. -Visual X# and Progmasoft share ownership, not a single interchangeable +Tala and Progmasoft share ownership, not a single interchangeable mark. The corporate four-color artwork does not substitute for the purple leopard logo. A footer may name Progmasoft as the project owner without turning the language homepage into a corporate landing page. @@ -187,6 +187,6 @@ Before approving a copy change, check: identifiers? - Are internal notes and private file paths absent from the public page? - Are homepage and docs links still valid after repository movement? -- Are source attribution and the Visual X# leopard identity intact? +- Are source attribution and the Tala leopard identity intact? - Are there any unintended account or package links on this language site? - Can a reader distinguish site availability from compiler readiness? diff --git a/Documents/LOCALIZATION.md b/Documents/LOCALIZATION.md index d94e299..e139050 100644 --- a/Documents/LOCALIZATION.md +++ b/Documents/LOCALIZATION.md @@ -61,7 +61,7 @@ follows the language. reads left to right. - Code blocks stay left to right. - The onward arrow comes from `forwardArrow` and points left in Hebrew. -- A left-to-right mark (``) follows `Visual X#` and `C#` in Hebrew strings. Without it the `#` jumps to the +- A left-to-right mark (``) follows a name that ends in a symbol, such as `C#`, in Hebrew strings. Without it the `#` jumps to the other side of the name inside right-to-left text. The rules are at the end of `frontend/src/styles/site.css` and `forum/site.css`. diff --git a/Documents/OPERATIONS.md b/Documents/OPERATIONS.md index 3c3bff9..72ab09a 100644 --- a/Documents/OPERATIONS.md +++ b/Documents/OPERATIONS.md @@ -1,7 +1,7 @@ <!-- SPDX-FileCopyrightText: 2026 Progmasoft <support@progmasoft.com> --> <!-- SPDX-License-Identifier: AGPL-3.0-or-later WITH AdditionRef-Progmasoft-Patent-Grant-1.1 --> -# Visual X# website operations +# Tala website operations This runbook covers only the language website and its not-yet-open forum page. The account site, corporate site, and package service have their own repositories @@ -77,7 +77,7 @@ browser review of both themes, all four languages, and narrow screens. ## Asset checks -The source brand file is the supplied Visual X# SVG. The wide, transparent +The source brand file is the supplied Tala SVG. The wide, transparent composition is used in the hero. The leopard-only crop is used for favicon and the small header mark so the animal remains legible at small sizes. The social preview is a 1280 × 640 PNG with an intentional background. It is @@ -88,12 +88,12 @@ Before publication, verify that: 1. The leopard is not cropped at either its nose or lower outline. 2. The full wordmark is readable in the hero at desktop and mobile widths. 3. The light theme has adequate contrast, including links and focus rings. -4. The social PNG matches the approved Visual X# identity. +4. The social PNG matches the approved Tala identity. 5. No page unintentionally uses a Progmasoft corporate logo. ## Link checks -All source links should target the current `Progmasoft/visual-xsharp` default +All source links should target the current `Progmasoft/tala` default branch. In particular, check the `Spec/`, `Documents/BUILDING.md`, `Documents/CLI.md`, and `Examples/` targets after any repository move. The only frontend navigation routes are `/`, `/docs/overview`, and diff --git a/Documents/README.md b/Documents/README.md index 6bdfa8a..55d8b40 100644 --- a/Documents/README.md +++ b/Documents/README.md @@ -3,7 +3,7 @@ # Website documentation -These documents describe the Visual X# language website as it is built and published today. +These documents describe the Tala language website as it is built and published today. | Document | Read it when you want to know | | --- | --- | |