Skip to content

Comments

Add section about metadata#944

Merged
gilgongo merged 1 commit intojamulussoftware:next-releasefrom
ann0see:docMetadata
Aug 5, 2023
Merged

Add section about metadata#944
gilgongo merged 1 commit intojamulussoftware:next-releasefrom
ann0see:docMetadata

Conversation

@ann0see
Copy link
Member

@ann0see ann0see commented Jul 30, 2023

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

  • I've verified that this Pull Request follows the general code principles
  • I waited some time after this Pull Request was opened and all GitHub checks completed without errors.
  • I'm sure that this Pull Request goes to the correct branch

@ann0see
Copy link
Member Author

ann0see commented Jul 30, 2023

@mcfnord I think you should review this PR as you seem to be interested in this topic. The standard should NOT be discussed here.

@ann0see
Copy link
Member Author

ann0see commented Jul 30, 2023

(needs a local check - especially if the HTML comments are correctly parsed)

@ann0see ann0see force-pushed the docMetadata branch 2 times, most recently from 4dd4840 to 1db0897 Compare July 30, 2023 17:26
@ann0see
Copy link
Member Author

ann0see commented Jul 30, 2023

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.
Copy link
Contributor

@mcfnord mcfnord Jul 30, 2023

Choose a reason for hiding this comment

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

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.

Copy link
Member Author

Choose a reason for hiding this comment

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

Tools can extract it - and probably also jamulus explorer could parse it and display it in a new field.

Copy link
Contributor

Choose a reason for hiding this comment

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

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?

Copy link
Contributor

@pljones pljones Jul 31, 2023

Choose a reason for hiding this comment

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

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.

Copy link
Contributor

Choose a reason for hiding this comment

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

Why not? Require an admin contact email someday. You could announce new releases via email. It'd be grand.

Copy link
Member Author

Choose a reason for hiding this comment

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

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.

Copy link
Contributor

Choose a reason for hiding this comment

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

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.

@mcfnord
Copy link
Contributor

mcfnord commented Jul 30, 2023

My conclusions come up a lot for me when considering this stuff:

a) We are removing the CLI example from headless guidance,
b) --welcomemessage used in systemctl introduces inherently tricky location file requirements that my recent documentation improvement only hints about. I had hoped to deliver much more helpful guidance on this.
c) A default /etc/jamulus/welc.html would circumvent this by providing a file already configured for use where we could ship with default metadata, or just an empty file, which might behave the same as no welcome file, the current default.

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.

@ann0see
Copy link
Member Author

ann0see commented Jul 30, 2023

We are removing the CLI example from headless guidance,

I don't see where it got removed unfortunately.

--welcomemessage used in systemctl introduces inherently tricky location file requirements that my recent documentation improvement only hints about. I had hoped to deliver much more helpful guidance on this.

Yes, but out of scope of this PR.

I want to give people a reasonable way to use this interface, before giving them the interface.

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.

@mcfnord
Copy link
Contributor

mcfnord commented Jul 30, 2023

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.

@ann0see
Copy link
Member Author

ann0see commented Jul 30, 2023

I still think a generalised standard should be documented. But maybe not that prominently? How else should admins know about it?

@mcfnord
Copy link
Contributor

mcfnord commented Jul 31, 2023

I don't see where it got removed unfortunately.

In the next release, we remove:

The following minimum setup is required to run a Registered Server:

jamulus --nogui --server
--directoryserver genreServer:port
--serverinfo "yourServerName;yourCity;[country ID]"

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.

@ann0see
Copy link
Member Author

ann0see commented Jul 31, 2023

Ok. I wasn't aware of this @gilgongo can we add this back?

ann0see pushed a commit to ann0see/jamuluswebsite that referenced this pull request Jul 31, 2023
@gilgongo
Copy link
Member

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.

@ann0see
Copy link
Member Author

ann0see commented Aug 2, 2023

@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]>
@ann0see
Copy link
Member Author

ann0see commented Aug 2, 2023

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.

This was referenced Aug 2, 2023
@gilgongo gilgongo merged commit 439610b into jamulussoftware:next-release Aug 5, 2023
@ann0see ann0see deleted the docMetadata branch August 5, 2023 11:21
ann0see added a commit that referenced this pull request Sep 3, 2023
* 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]>
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.

4 participants