Skip to content

Comments

[EN] Corrections.#286

Merged
ann0see merged 47 commits intojamulussoftware:changesfrom
ignotus666:changes_revision
Feb 17, 2021
Merged

[EN] Corrections.#286
ann0see merged 47 commits intojamulussoftware:changesfrom
ignotus666:changes_revision

Conversation

@ignotus666
Copy link
Member

I'm making a pull request to the 'changes' branch as many of the edits need to be included in the translations (e.g. corrected website addresses). Many corrections are just of typos, but in other instances sentences have been changed where I thought they were too vague - though suggestions are welcome.

@trebmuh
Copy link
Member

trebmuh commented Feb 10, 2021

LGTM

Copy link
Member

@ann0see ann0see left a comment

Choose a reason for hiding this comment

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

Thanks very much for yor work! This looks great. See my comments.

You can test whether you are hearing your signal correctly by doing the following:

1. Get your audio into your computer.
1. Connect your audio source (mic, instrument...) to your computer.
Copy link
Member

Choose a reason for hiding this comment

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

remark-lint reported some issues here. I think we might need to go through the whole wiki and fix syntax errors.
That's nothing you should need to worry about now.

Copy link
Member Author

Choose a reason for hiding this comment

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

Yeah, I didn't have a clue what it was on about.

1. **A computer** running either **Windows 10**, **macOS** (**MacOS X** El Capitan v10.11 or higher), or **Linux**.
1. **A wired internet connection** (don't use Wi-Fi, it will cause sound problems). Most broadband connections will be fine[^1].
1. **Wired headphones - not speakers** to prevent echo or feedback and to minimize delay[^2].
1. **Wired headphones - not speakers** to prevent echo or feedback and to minimise delay[^2].
Copy link
Member

Choose a reason for hiding this comment

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

I think we already had a discussion about BE/AE and I think minimize is also ok in BE?

Copy link
Member Author

Choose a reason for hiding this comment

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

Minimise is preferred in BE.

If you're on amd64 **Debian**/**Ubuntu**, you may try the compiled .deb packages from GitHub Actions.

1. Download the jamulus_latest_ubuntu_amd64.deb file from the [Jamulus GitHub release](https://github.com/corrados/jamulus/releases/tag/latest) page
1. Download the jamulus_latest_ubuntu_amd64.deb file from the [Jamulus GitHub release](https://github.com/jamuluswebsite/jamulus/releases/tag/latest) page
Copy link
Member

Choose a reason for hiding this comment

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

We'll probably need to update this link once the release is made. Also apt --fix-broken install is needed on a clean machine. (Not sure if there's a cleaner way to install the dependencies...)

Copy link
Contributor

Choose a reason for hiding this comment

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

Ideally we'd just tell people to install from their distribution, rather than from here. They'll likely feel happier about doing it, too, and once it's installed, it'll keep them up to date fairly easily.

We should advise people that many distributions do provide a current version of Jamulus and they only need build it themselves if either they want to get involved in development or their distribution doesn't supply it (and we'd appreciate volunteers for distributions taking on provision as a way of getting involved).

Copy link
Member

Choose a reason for hiding this comment

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

Agree. #287 might be something we should include here? Probably the installation on Linux needs to be rewritten.

Copy link
Member

Choose a reason for hiding this comment

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

The Linux installation stuff needs to be re-done now that we're in the repos properly, with compilation instructions relegated to a file in the repo I think (and just linked to in passing from the website).

But in the interests of time, can we keep as is? Release is coming soon...

## Points to note about inputs

- If you want to connect 2 or more sources (eg voice + synth + guitar), it is important to note that Jamulus currently handles only input 2 channels (L/R). So the hardware being used must provide a mixed-down stereo output to Jamulus.
- If you want to connect 2 or more sources (e.g. voice + synth + guitar), it is important to note that Jamulus currently handles only 2 input channels (L/R). So the hardware being used must provide a mixed-down stereo output to Jamulus.
Copy link
Contributor

Choose a reason for hiding this comment

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

"Alternatively run two instances of Jamulus, if your hardware input supports it. Or use virtual audio inputs to Jamulus for each hardware input."

I don't mind keeping it simple - but the original is wrong in the sense it states that no other solution is possible.

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 was mainly sticking to revising existing text - but if the rest of you think that extra info should go in, I'll add it.

Copy link
Contributor

Choose a reason for hiding this comment

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

I know what you mean - and I'm not going to hold up this improvement just because it doesn't get us 100% perfection in one hit :).

Copy link
Member Author

Choose a reason for hiding this comment

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

Done.

If you're on amd64 **Debian**/**Ubuntu**, you may try the compiled .deb packages from GitHub Actions.

1. Download the jamulus_latest_ubuntu_amd64.deb file from the [Jamulus GitHub release](https://github.com/corrados/jamulus/releases/tag/latest) page
1. Download the jamulus_latest_ubuntu_amd64.deb file from the [Jamulus GitHub release](https://github.com/jamuluswebsite/jamulus/releases/tag/latest) page
Copy link
Contributor

Choose a reason for hiding this comment

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

Ideally we'd just tell people to install from their distribution, rather than from here. They'll likely feel happier about doing it, too, and once it's installed, it'll keep them up to date fairly easily.

We should advise people that many distributions do provide a current version of Jamulus and they only need build it themselves if either they want to get involved in development or their distribution doesn't supply it (and we'd appreciate volunteers for distributions taking on provision as a way of getting involved).

![Connect dialog](https://user-images.githubusercontent.com/20726856/97360965-31d76b00-189f-11eb-870b-f58be6e30f04.png)

The Connection Setup window shows a list of available servers together with the number of occupants and the maximum number supported. Server operators can optionally list their servers by musical genre. Use the List dropdown to select a genre, click on the server you want to join and press the Connect button to connect to it. Alternatively, double-click on the server name. Permanent servers (those that have been listed for longer than 24 hours) are shown in bold.
The Connection Setup window shows a list of available servers together with the number of occupants and the maximum number supported. Server operators can optionally list their servers by music genre. Use the List dropdown to select a genre, click on the server you want to join and press the Connect button to connect to it. Alternatively, double-click on the server name. Permanent servers (those that have been listed for longer than 24 hours) are shown in bold.
Copy link
Contributor

@pljones pljones Feb 15, 2021

Choose a reason for hiding this comment

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

It's not optional. All registered servers have a server list. Some of the server lists are genre-specific. There could be location-specific ones. But they're all on lists. I think this needs explaining more clearly.

Copy link
Member

Choose a reason for hiding this comment

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

This is the client's manual don't forget, so we're talking about their view of that list. But maybe we can just drop that line so it reads:

"... the maximum number supported. Use the List dropdown to select a genre, click on the server..."

Copy link
Member Author

Choose a reason for hiding this comment

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

Rephrased it. See what you reckon.

@pljones
Copy link
Contributor

pljones commented Feb 15, 2021

Getting there - I never see everything in one pass when reviewing...

@gilgongo
Copy link
Member

So shall I give this a merge?

@ann0see
Copy link
Member

ann0see commented Feb 17, 2021

Any updates here? Ready to merge?

@ann0see
Copy link
Member

ann0see commented Feb 17, 2021

I will merge this now.

@ann0see ann0see merged commit 67d6949 into jamulussoftware:changes Feb 17, 2021
@ignotus666 ignotus666 deleted the changes_revision branch February 17, 2021 21:07
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.

5 participants