Add section about metadata#944
Conversation
|
@mcfnord I think you should review this PR as you seem to be interested in this topic. The standard should NOT be discussed here. |
|
(needs a local check - especially if the HTML comments are correctly parsed) |
4dd4840 to
1db0897
Compare
|
Fixed. @mcfnord Also the link works locally. |
|
|
||
| <!--more--> | ||
|
|
||
| You can add metadata to your server for many purposes. Adding contact information like the E-Mail or Website of the Server administrator helps users to contact the administrator if something goes wrong with the server. Also adding policies for bots allows them to judge if they can or cannot connect to the server. |
There was a problem hiding this comment.
It only helps if there's a straightforward way for users to find or use this information. Including this information in clear text is arguably much more useful than hiding it as our HTML will do. If I wanted users to easily contact me, providing a visible email or website address seems foolproof, while a hidden metadata entry is... useless at this point, right? So I'm not sure we've thought through how this guidance would help. Eventually it might be discoverable at both Jamulus Explorer and Live, but until then, I'm not sure it's worth recommending.
There was a problem hiding this comment.
Tools can extract it - and probably also jamulus explorer could parse it and display it in a new field.
There was a problem hiding this comment.
The user's discovery is highly diminished vs. clear text. I don't see how we could beat guidance that says, "Hey, put your email address in your welcome message." Putting it in hidden text gains us... what?
There was a problem hiding this comment.
The point of "metadata" is not to be human-readable. It's directed at machines and should be in an easily machine-parseable format.
Anyone can put any human-visible text in their welcome message already.
Using <!-- and --> allows a parser to delimit the metadata - which, for a parser, is fairly necessary - otherwise it's guesswork.
The idea here was that we'd say, "Hey, if you want to tag up your server so it has machine readable data, here's how we suggest you do it."
Then if someone says "Hey, it'd be cool if you tag your server up with <some info I want to parse> using <this suggested tag>" we already have that idea embedded in the documentation and it's not alien to server operators. It would be down to the person wanting to scrape the information to make sure they weren't clashing with anything that existed for other purposes. It might be that we end up with a page logging metadata tags and their meanings, as people add them - but that wouldn't be owned by anyone other than the people using the tags.
It's definitely never going to be something Jamulus itself is interested in.
There was a problem hiding this comment.
Why not? Require an admin contact email someday. You could announce new releases via email. It'd be grand.
There was a problem hiding this comment.
I think this goes against the policy of Jamulus being open. Also alerting people via E-Mail should be opt in.
The point of "metadata" is not to be human-readable. It's directed at machines and should be in an easily machine-parseable format.
Exactly. I think we should drop the talk about admin contact here.
Focus on a generalized metadata format.
There was a problem hiding this comment.
I've suggested focusing on bot policy, and also suggested brainstorming good candidates for metadata usage. Surely someone could think of more than one usage of this generalized format before you tout it.
|
My conclusions come up a lot for me when considering this stuff: a) We are removing the CLI example from headless guidance, I want to give people a reasonable way to use this interface, before giving them the interface. Without some additional steps, we are making welcome messages harder to use, while increasing the features hidden there. Formula for pain. I want to score a major victory for welcome message usage on systemd headless Linux by delivering /etc/jamulus/welc.html as an empty file in v1. |
I don't see where it got removed unfortunately.
Yes, but out of scope of this PR.
I'd like to have a draft out for adoption - just as KB entry, which means it's a living document and can be updated at any time. The documentation however (Running a server) should already have a link as this needs translation and isn't easily updatable if no release is happening. |
|
For these reasons, I think the KB is limited in scope to bot policy. I don't want to advocate for describing a generalized metadata infrastructure to users (even if we have one) because I don't want to invite anyone to think metadata is where they communicate to users. |
|
I still think a generalised standard should be documented. But maybe not that prominently? How else should admins know about it? |
In the next release, we remove:
This means we will mandate usage of systemctl, unless you have the Secret Knowledge of CLI usage. And that's why I go so hard against the serious complexity involved using a welcome file. Previously I advocated for a two-part Running a Server page: a Quickstart that concluded with the server running at the CLI on a public directory, followed by the deeper dive into usage based on systemctl. I still recommend that design because I believe it would lead to more operator successes. |
|
Ok. I wasn't aware of this @gilgongo can we add this back? |
I seem to recall I wanted it in (it was me who put it in originally), but there was some discussion about default configurations and it being misleading in some way? Can't recall. |
|
@gilgongo could you please re-add it (with a PR)? |
Co-authored-by: John Dempsey <[email protected]> Co-authored-by: John Dempsey <[email protected]> Co-authored-by: John Dempsey <[email protected]>
|
Can we agree to merge and discuss the content in the mentioned discussion? Maybe we add a disclaimer to the KB entry that it's a WIP. |
* Change 'pt' to 'pt_PT' * JSON-RPC: Update for --jsonrpcbindip Update documentation for --jsonrpcbindip command line argument. * Update scripts for new po4a version and better markdown support * Remove unneeded lines and stats script * Relocate to proper sections, View rather than Edit, shift-click-drag (#862) * relocate GRP details to GRP section, and ordering details to the general section, rather than SOLO. Co-authored-by: jrd <[email protected]> * AUTO: Updated .po files * Translations update from Hosted Weblate (#870) * Update translation files Updated by "Squash Git commits" hook in Weblate. Co-authored-by: Hosted Weblate <[email protected]> Translate-URL: https://hosted.weblate.org/projects/jamulus/faq/ Translation: Jamulus/FAQ * Update translation files Updated by "Squash Git commits" hook in Weblate. Co-authored-by: Hosted Weblate <[email protected]> Translate-URL: https://hosted.weblate.org/projects/jamulus/faq/ Translation: Jamulus/FAQ * Update translation files Updated by "Squash Git commits" hook in Weblate. Co-authored-by: Hosted Weblate <[email protected]> Translate-URL: https://hosted.weblate.org/projects/jamulus/faq/ Translation: Jamulus/FAQ * Update translation files Updated by "Squash Git commits" hook in Weblate. Translation: Jamulus/Server-Bandwidth Translate-URL: https://hosted.weblate.org/projects/jamulus/server-bandwidth/ * Fix conflict * Revert "Fix conflict" This reverts commit 8c9509d. Co-authored-by: ignotus <[email protected]> * Update Spanish translation using Weblate Currently translated at 100.0% (134 of 134 strings) Co-authored-by: ignotus <[email protected]> Translate-URL: https://hosted.weblate.org/projects/jamulus/software-manual/es/ Translation: Jamulus/Software-Manual * Update translation files Updated by "Squash Git commits" hook in Weblate. Co-authored-by: Hosted Weblate <[email protected]> Translate-URL: https://hosted.weblate.org/projects/jamulus/getting-started/ Translation: Jamulus/Getting-Started * Update translation files Updated by "Squash Git commits" hook in Weblate. Translation: Jamulus/Software-Manual Translate-URL: https://hosted.weblate.org/projects/jamulus/software-manual/ * De-emphasise ARM downloads on Linux server page * Update Installation-for-Linux.md * Update for style Co-authored-by: John Dempsey <[email protected]> * Add "download" for ARM binaries Co-authored-by: John Dempsey <[email protected]> * AUTO: Updated .po files * AUTO: Updated .po files * Remove unneeded trailing slash of void elements HTML void elements should not use trailing slashes: https://github.com/validator/validator/wiki/Markup-%C2%BB-Void-elements#trailing-slashes This removes (hopefully) all of them Note: SVG images do need them. * Update translation files Updated by "Squash Git commits" hook in Weblate. Co-authored-by: Hosted Weblate <[email protected]> Translate-URL: https://hosted.weblate.org/projects/jamulus/software-manual/ Translation: Jamulus/Software-Manual * Update translation files Updated by "Squash Git commits" hook in Weblate. Translation: Jamulus/Directories Translate-URL: https://hosted.weblate.org/projects/jamulus/directories/ * Add missing dependency to script and re-name key (#884) * Add missing dependency to script and re-name key * Change cache key * Add dependency * Correct dependency spelling * Revert key name to po4a-0.68 (#885) * Revert key name to po4a-0.68 * Update jekyll.yml * Update main.yml * AUTO: Updated .po files * AUTO: Updated .po files * Remove occurances of master from translation * Test remove duplicate mail * Add workflow dispatch to jekyll This should also allow to build .po files manually * AUTO: Updated .po files * Remove PT files (#890) * Translations update from Hosted Weblate (#888) * Update Portuguese translation using Weblate Currently translated at 16.6% (3 of 18 strings) Co-authored-by: Augusto Kakuja Santos <[email protected]> Translate-URL: https://hosted.weblate.org/projects/jamulus/general/pt/ Translation: Jamulus/General strings * Update translation files Updated by "Squash Git commits" hook in Weblate. Translation: Jamulus/General strings Translate-URL: https://hosted.weblate.org/projects/jamulus/general/ * Delete _translator-files/po/pt directory Co-authored-by: Augusto Kakuja Santos <[email protected]> Co-authored-by: ignotus <[email protected]> * Fix IT .po file (#891) * Fix IT .po file * Fixes * Remove spaces * AUTO: Updated .po files * Server admin guide re-structure (#877) Co-authored-by: John Dempsey <[email protected]> Peter L Jones <[email protected]> ann0see <[email protected]> * AUTO: Updated .po files * Revert "AUTO: Updated .po files" This reverts commit 4e35643. * Revert "Server admin guide re-structure (#877)" This reverts commit c5fffb2. * Translations update from Hosted Weblate (#893) * Update translation files Updated by "Squash Git commits" hook in Weblate. Co-authored-by: Hosted Weblate <[email protected]> Translate-URL: https://hosted.weblate.org/projects/jamulus/running-a-server/ Translation: Jamulus/Running-a-Server * Update German translation using Weblate Currently translated at 66.6% (8 of 12 strings) Co-authored-by: Ettore Atalan <[email protected]> Translate-URL: https://hosted.weblate.org/projects/jamulus/include-shared-commands/de/ Translation: Jamulus/Include-Shared-Commands * Update translation files Updated by "Squash Git commits" hook in Weblate. Co-authored-by: Hosted Weblate <[email protected]> Translate-URL: https://hosted.weblate.org/projects/jamulus/running-a-server/ Translation: Jamulus/Running-a-Server * Update translation files Updated by "Squash Git commits" hook in Weblate. Translation: Jamulus/Include-Shared-Commands Translate-URL: https://hosted.weblate.org/projects/jamulus/include-shared-commands/ Co-authored-by: Ettore Atalan <[email protected]> * Serverdocs re-structure (re-merge) (#895) Co-authored-by: John Dempsey <[email protected]> Peter L Jones <[email protected]> ann0see <[email protected]> * AUTO: Updated .po files * Add small "quick start" Making it clear what the installation will give you. * AUTO: Updated .po files * Typo * AUTO: Updated .po files * Capitalisation, repetition * AUTO: Updated .po files * Update po4a requirements * Make copyright file translatable * Update translation files Updated by "Squash Git commits" hook in Weblate. Co-authored-by: Hosted Weblate <[email protected]> Translate-URL: https://hosted.weblate.org/projects/jamulus/tips-tricks-more/ Translation: Jamulus/Tips-Tricks-More * Update translation files Updated by "Squash Git commits" hook in Weblate. Co-authored-by: Hosted Weblate <[email protected]> Translate-URL: https://hosted.weblate.org/projects/jamulus/tips-tricks-more/ Translation: Jamulus/Tips-Tricks-More * Update translation files Updated by "Squash Git commits" hook in Weblate. Co-authored-by: Hosted Weblate <[email protected]> Translate-URL: https://hosted.weblate.org/projects/jamulus/tips-tricks-more/ Translation: Jamulus/Tips-Tricks-More * Update translation files Updated by "Squash Git commits" hook in Weblate. Translation: Jamulus/Navigation Translate-URL: https://hosted.weblate.org/projects/jamulus/navigation/ * AUTO: Updated .po files * Corrections to EN files (#899) Co-authored-by: John Dempsey <[email protected]> * AUTO: Updated .po files * Updated Privacy Statement (#872) Co-authored-by: ignotus <[email protected]> Co-authored-by: John Dempsey <[email protected]> Co-authored-by: Jonathan <[email protected]> Co-authored-by: ann0see <[email protected]> Co-authored-by: Peter L Jones <[email protected]> * AUTO: Updated .po files * Revert "AUTO: Updated .po files" This reverts commit 81d3700. * Revert "Updated Privacy Statement (#872)" This reverts commit 212abdd. * Revert "AUTO: Updated .po files" This reverts commit 34d4b3a. * Revert "Corrections to EN files (#899)" This reverts commit 25995a5. * Translations update from Hosted Weblate (#903) * Update translation files Updated by "Squash Git commits" hook in Weblate. Co-authored-by: Hosted Weblate <[email protected]> Translate-URL: https://hosted.weblate.org/projects/jamulus/command-line-options/ Translation: Jamulus/Command-Line-Options * Update translation files Updated by "Squash Git commits" hook in Weblate. Co-authored-by: Hosted Weblate <[email protected]> Translate-URL: https://hosted.weblate.org/projects/jamulus/command-line-options/ Translation: Jamulus/Command-Line-Options * Update translation files Updated by "Squash Git commits" hook in Weblate. Co-authored-by: Hosted Weblate <[email protected]> Translate-URL: https://hosted.weblate.org/projects/jamulus/command-line-options/ Translation: Jamulus/Command-Line-Options * Update translation files Updated by "Squash Git commits" hook in Weblate. Translation: Jamulus/Unregistered-Servers Translate-URL: https://hosted.weblate.org/projects/jamulus/unregistered-servers/ * En corrections (#905) Co-authored-by: John Dempsey <[email protected]> Co-authored-by: Jonathan <[email protected]> * AUTO: Updated .po files * Update Unregistered-Servers.md (#904) Authored by: Ginjo Co-authored-by: John Dempsey <[email protected]> * AUTO: Updated .po files * Update privacy statement (#906) Authored by: Rob-NY Co-authored-by: ignotus <[email protected]> Co-authored-by: John Dempsey <[email protected]> Co-authored-by: Jonathan <[email protected]> * AUTO: Updated .po files * Running a Server.md : fixes wrong ponctuation * AUTO: Updated .po files * Document JSON-RPC API (#909) * AUTO: Updated .po files * Revert "AUTO: Updated .po files" This reverts commit b81d704. * Update po4a create script to set location for copyright file (#917) Update po4a create script to set the correct location for copyright file so that is is used in translated version of the website. * Check language tag in '1-index.html' and replace if incorrect * Update sed command * Translations update from Hosted Weblate (#908) * Update translation files Updated by "Squash Git commits" hook in Weblate. Co-authored-by: Hosted Weblate <[email protected]> Translate-URL: https://hosted.weblate.org/projects/jamulus/installation-for-windows/ Translation: Jamulus/Installation-for-Windows * Update translation files Updated by "Squash Git commits" hook in Weblate. Co-authored-by: Hosted Weblate <[email protected]> Translate-URL: https://hosted.weblate.org/projects/jamulus/installation-for-windows/ Translation: Jamulus/Installation-for-Windows * Update translation files Updated by "Squash Git commits" hook in Weblate. Co-authored-by: Hosted Weblate <[email protected]> Translate-URL: https://hosted.weblate.org/projects/jamulus/installation-for-windows/ Translation: Jamulus/Installation-for-Windows * Update translation files Updated by "Squash Git commits" hook in Weblate. Co-authored-by: Hosted Weblate <[email protected]> Translate-URL: https://hosted.weblate.org/projects/jamulus/installation-for-windows/ Translation: Jamulus/Installation-for-Windows * Update translation files Updated by "Squash Git commits" hook in Weblate. Co-authored-by: Hosted Weblate <[email protected]> Translate-URL: https://hosted.weblate.org/projects/jamulus/installation-for-windows/ Translation: Jamulus/Installation-for-Windows * Update translation files Updated by "Squash Git commits" hook in Weblate. Co-authored-by: Hosted Weblate <[email protected]> Translate-URL: https://hosted.weblate.org/projects/jamulus/installation-for-windows/ Translation: Jamulus/Installation-for-Windows * Update translation files Updated by "Squash Git commits" hook in Weblate. Translation: Jamulus/Running-a-Server Translate-URL: https://hosted.weblate.org/projects/jamulus/running-a-server/ * Fix wrong formatting and links in EN files (#921) * AUTO: Updated .po files * Translations update from Hosted Weblate (#922) * Update translation files Updated by "Squash Git commits" hook in Weblate. Co-authored-by: Hosted Weblate <[email protected]> Translate-URL: https://hosted.weblate.org/projects/jamulus/privacy-statement/ Translation: Jamulus/Privacy-Statement * Update translation files Updated by "Squash Git commits" hook in Weblate. Co-authored-by: Hosted Weblate <[email protected]> Translate-URL: https://hosted.weblate.org/projects/jamulus/privacy-statement/ Translation: Jamulus/Privacy-Statement * Update translation files Updated by "Squash Git commits" hook in Weblate. Co-authored-by: Hosted Weblate <[email protected]> Translate-URL: https://hosted.weblate.org/projects/jamulus/privacy-statement/ Translation: Jamulus/Privacy-Statement * Update translation files Updated by "Squash Git commits" hook in Weblate. Co-authored-by: Hosted Weblate <[email protected]> Translate-URL: https://hosted.weblate.org/projects/jamulus/privacy-statement/ Translation: Jamulus/Privacy-Statement * Update translation files Updated by "Squash Git commits" hook in Weblate. Translation: Jamulus/Directories Translate-URL: https://hosted.weblate.org/projects/jamulus/directories/ * Rephrase quick download title Related to: #843 * Make download of legacy versions less obvious The legacy builds and old versions of Jamulus should not be preferred, so this makes them less prominent * Fix typo * AUTO: Updated .po files * Shorten landing page Related to #843 * Update wiki/en/misc/1-index.html Co-authored-by: John Dempsey <[email protected]> * Reword introduction Co-authored-by: John Dempsey <[email protected]> * More rewording * Add missing link to legacy downloads * AUTO: Updated .po files * 919 Update "--directoryserver" to "--directoryaddress" * AUTO: Updated .po files * Remove obsolete .po files (#930) * Client screenshots * Client screenshot description * AUTO: Updated .po files * Translations update from Hosted Weblate (#925) * Update translation files Updated by "Squash Git commits" hook in Weblate. Co-authored-by: Hosted Weblate <[email protected]> Translate-URL: https://hosted.weblate.org/projects/jamulus/getting-started/ Translation: Jamulus/Getting-Started * Update translation files Updated by "Squash Git commits" hook in Weblate. Co-authored-by: Hosted Weblate <[email protected]> Translate-URL: https://hosted.weblate.org/projects/jamulus/getting-started/ Translation: Jamulus/Getting-Started * Update translation files Updated by "Squash Git commits" hook in Weblate. Translation: Jamulus/Software-Manual Translate-URL: https://hosted.weblate.org/projects/jamulus/software-manual/ * KB: Add description server extension suite, KOORD and Melomax (#932) * mention dtinth suite * Include Koord * Melomax * Add hint that path to welcome message file must be accessible (#933) See also: #927 * AUTO: Updated .po files * Add giscus to privacy statement * AUTO: Updated .po files * Add documentation for deb repo * Change wording Co-authored-by: Peter L Jones <[email protected]> * Update project board url * Change naming of giscus to lower case Their repository says giscus not Giscus * AUTO: Updated .po files * AUTO: Updated .po files * Remove infobox for release note Fixes: #924 * Use codeblocks for repo * Update translation files Updated by "Squash Git commits" hook in Weblate. Co-authored-by: Hosted Weblate <[email protected]> Translate-URL: https://hosted.weblate.org/projects/jamulus/privacy-statement/ Translation: Jamulus/Privacy-Statement * Update translation files Updated by "Squash Git commits" hook in Weblate. Co-authored-by: Hosted Weblate <[email protected]> Translate-URL: https://hosted.weblate.org/projects/jamulus/privacy-statement/ Translation: Jamulus/Privacy-Statement * Update translation files Updated by "Squash Git commits" hook in Weblate. Co-authored-by: Hosted Weblate <[email protected]> Translate-URL: https://hosted.weblate.org/projects/jamulus/privacy-statement/ Translation: Jamulus/Privacy-Statement * Update translation files Updated by "Squash Git commits" hook in Weblate. Co-authored-by: Hosted Weblate <[email protected]> Translate-URL: https://hosted.weblate.org/projects/jamulus/privacy-statement/ Translation: Jamulus/Privacy-Statement * Update translation files Updated by "Squash Git commits" hook in Weblate. Co-authored-by: Hosted Weblate <[email protected]> Translate-URL: https://hosted.weblate.org/projects/jamulus/privacy-statement/ Translation: Jamulus/Privacy-Statement * Update translation files Updated by "Squash Git commits" hook in Weblate. Translation: Jamulus/Running-a-Server Translate-URL: https://hosted.weblate.org/projects/jamulus/running-a-server/ * Add more text to link Context: #944 (comment) * AUTO: Updated .po files * AUTO: Updated .po files * AUTO: Updated .po files * Update translation files Updated by "Squash Git commits" hook in Weblate. Co-authored-by: Hosted Weblate <[email protected]> Translate-URL: https://hosted.weblate.org/projects/jamulus/running-a-server/ Translation: Jamulus/Running-a-Server * Update translation files Updated by "Squash Git commits" hook in Weblate. Translation: Jamulus/Navigation Translate-URL: https://hosted.weblate.org/projects/jamulus/navigation/ * Update translation files Updated by "Squash Git commits" hook in Weblate. Co-authored-by: Hosted Weblate <[email protected]> Translate-URL: https://hosted.weblate.org/projects/jamulus/include-client-commands/ Translation: Jamulus/Include-Client-Commands * Update translation files Updated by "Squash Git commits" hook in Weblate. Translation: Jamulus/Directories Translate-URL: https://hosted.weblate.org/projects/jamulus/directories/ * Make and on main homepage translatable * AUTO: Updated .po files * Fix logical error for DNS Co-authored-by: Peter L Jones <[email protected]> * AUTO: Updated .po files * Re-add documentation for running a Server from CLI Co-authored-by: ann0see <[email protected]> * AUTO: Updated .po files * Sharpen NAT definition * Do not mention band only * Remove redundancy * AUTO: Updated .po files * Document macOS ini file sandbox requirements (#936) * AUTO: Updated .po files * Add KB entry for metadata (#944) Co-authored-by: John Dempsey <[email protected]> * AUTO: Updated .po files * Update NL inc links * Update settings-network.inc * Update settings-advanced.inc * server-window-inc * Delete server-window-options.inc * Delete server-window-setup.inc * Update German translation using Weblate Currently translated at 30.1% (47 of 156 strings) Update translation files Updated by "Squash Git commits" hook in Weblate. Co-authored-by: Hosted Weblate <[email protected]> Co-authored-by: ann0see <[email protected]> Translate-URL: https://hosted.weblate.org/projects/jamulus/navigation/ Translate-URL: https://hosted.weblate.org/projects/jamulus/running-a-server/de/ Translation: Jamulus/Navigation Translation: Jamulus/Running-a-Server * Update translation files Updated by "Squash Git commits" hook in Weblate. Co-authored-by: Hosted Weblate <[email protected]> Translate-URL: https://hosted.weblate.org/projects/jamulus/navigation/ Translation: Jamulus/Navigation * Update translation files Updated by "Squash Git commits" hook in Weblate. Co-authored-by: Hosted Weblate <[email protected]> Translate-URL: https://hosted.weblate.org/projects/jamulus/navigation/ Translation: Jamulus/Navigation * Update translation files Updated by "Squash Git commits" hook in Weblate. Co-authored-by: Hosted Weblate <[email protected]> Translate-URL: https://hosted.weblate.org/projects/jamulus/navigation/ Translation: Jamulus/Navigation * Update translation files Updated by "Squash Git commits" hook in Weblate. Co-authored-by: Hosted Weblate <[email protected]> Translate-URL: https://hosted.weblate.org/projects/jamulus/navigation/ Translation: Jamulus/Navigation * Update translation files Updated by "Squash Git commits" hook in Weblate. Co-authored-by: Hosted Weblate <[email protected]> Translate-URL: https://hosted.weblate.org/projects/jamulus/navigation/ Translation: Jamulus/Navigation * Update translation files Updated by "Squash Git commits" hook in Weblate. Co-authored-by: Hosted Weblate <[email protected]> Translate-URL: https://hosted.weblate.org/projects/jamulus/navigation/ Translation: Jamulus/Navigation * Update translation files Updated by "Squash Git commits" hook in Weblate. Translation: Jamulus/Running-a-Server Translate-URL: https://hosted.weblate.org/projects/jamulus/running-a-server/ * Fix Running-a-Server.md broken links (#960) * AUTO: Updated .po files * Update German translation using Weblate Currently translated at 100.0% (12 of 12 strings) Co-authored-by: ann0see <[email protected]> Translate-URL: https://hosted.weblate.org/projects/jamulus/include-shared-commands/de/ Translation: Jamulus/Include-Shared-Commands * Update translation files Updated by "Squash Git commits" hook in Weblate. Translation: Jamulus/Include-Shared-Commands Translate-URL: https://hosted.weblate.org/projects/jamulus/include-shared-commands/ * Fix links in translation * Update German translation using Weblate Currently translated at 100.0% (14 of 14 strings) Co-authored-by: ann0see <[email protected]> Translate-URL: https://hosted.weblate.org/projects/jamulus/installation-for-macintosh/de/ Translation: Jamulus/Installation-for-Macintosh * Update Spanish translation using Weblate Currently translated at 100.0% (14 of 14 strings) Co-authored-by: ann0see <[email protected]> Translate-URL: https://hosted.weblate.org/projects/jamulus/installation-for-macintosh/es/ Translation: Jamulus/Installation-for-Macintosh * Update Command-Line-Options.po links for French * Update Installation-for-Windows.po update links french * Update text to match app * Update text to match app * Definite article for small network buffers Co-authored-by: ann0see <[email protected]> * AUTO: Updated .po files * Update translation files Updated by "Squash Git commits" hook in Weblate. Co-authored-by: Hosted Weblate <[email protected]> Translate-URL: https://hosted.weblate.org/projects/jamulus/tips-tricks-more/ Translation: Jamulus/Tips-Tricks-More * Update translation files Updated by "Squash Git commits" hook in Weblate. Co-authored-by: Hosted Weblate <[email protected]> Translate-URL: https://hosted.weblate.org/projects/jamulus/tips-tricks-more/ Translation: Jamulus/Tips-Tricks-More * Update translation files Updated by "Squash Git commits" hook in Weblate. Translation: Jamulus/Unregistered-Servers Translate-URL: https://hosted.weblate.org/projects/jamulus/unregistered-servers/ * Translated using Weblate (German) Currently translated at 100.0% (31 of 31 strings) Co-authored-by: ann0see <[email protected]> Translate-URL: https://hosted.weblate.org/projects/jamulus/unregistered-servers/de/ Translation: Jamulus/Unregistered-Servers --------- Co-authored-by: Ignotus <[email protected]> Co-authored-by: Rob-NY <[email protected]> Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> Co-authored-by: John Dempsey <[email protected]> Co-authored-by: jrd <[email protected]> Co-authored-by: Weblate (bot) <[email protected]> Co-authored-by: Jonathan <[email protected]> Co-authored-by: Augusto Kakuja Santos <[email protected]> Co-authored-by: Ettore Atalan <[email protected]> Co-authored-by: Peter L Jones <[email protected]> Co-authored-by: Olivier HUMBERT <[email protected]> Co-authored-by: Henk De Groot <[email protected]> Co-authored-by: Peter L Jones <[email protected]> Co-authored-by: mcfnord <[email protected]> Co-authored-by: Julien Taverna <[email protected]>
Short description of changes
This adds a section about adding metadata to the server. I think we should get this in soon (for 3.10.0) in a minimal way and make it updatable to have quick adoption. The standard format proposed by @pljones was "easy".
This is JUST A START and discussion about the standard should continue in https://github.com/orgs/jamulussoftware/discussions/3086 - thus it is a KB entry.
Context: Fixes an issue? Related issues
Related to: https://github.com/orgs/jamulussoftware/discussions/3086
Status of this Pull Request
Ready for review
What is missing until this pull request can be merged?
Short ! review. The standard is to be discussed elsewhere.
Does this need translation?
YES
Checklist