diff --git a/CONTRIBUTING b/CONTRIBUTING
index dffe99d7189ea8bbfd020ca7b5ef9eaff50f4f2b..18d877b66868865a1bd187f1d76e51aaf3803be4 100644
--- a/CONTRIBUTING
+++ b/CONTRIBUTING
@@ -280,7 +280,7 @@ Typical workflow for a contribution
3. Create a dedicated branch for your work ``42-awesome-fix``. It is good practice to prefix your branch name with the ID of the issue you are solving.
4. Work on your stuff
5. Commit small, atomic changes to make it easier to review your contribution
-6. Add a changelog fragment to summarize your changes: ``echo "Implemented awesome stuff (#42)" > changes/changelog.d/42.feature"``
+6. Add a changelog fragment to summarize your changes: ``echo "Implemented awesome stuff (#42)" > changes/changelog.d/42.feature``
7. Push your branch
8. Create your merge request
9. Take a step back and enjoy, we're really grateful you did all of this and took the time to contribute!
diff --git a/changes/changelog.d/doc_small_fixes.doc b/changes/changelog.d/doc_small_fixes.doc
new file mode 100644
index 0000000000000000000000000000000000000000..fbdc5542a3eadd6b7f92614e6850f96e7bed1237
--- /dev/null
+++ b/changes/changelog.d/doc_small_fixes.doc
@@ -0,0 +1 @@
+Some cosmetic improvements to the doc
diff --git a/docs/configuration.rst b/docs/configuration.rst
index 6ec138e4cc61944f943d02e0db478b6b346a65f6..3e7b5aa25df89add324d1aab753b2303504c9efb 100644
--- a/docs/configuration.rst
+++ b/docs/configuration.rst
@@ -88,7 +88,7 @@ Default: ``Funkwhale <noreply@yourdomain>``
Default: ``None``
The path on your server where Funwkhale can import files using :ref:`in-place import
-<in-place-import>`. It must be readable by the webserver and funkwhale
+<in-place-import>`. It must be readable by the webserver and Funkwhale
api and worker processes.
On docker installations, we recommend you use the default of ``/music``
diff --git a/docs/features.rst b/docs/features.rst
index e0f490e4b741676085e2bc6cbeae01c8e5d19f85..8d1d3716a7802f262435c1251ad2a49ffeca34a1 100644
--- a/docs/features.rst
+++ b/docs/features.rst
@@ -9,7 +9,7 @@ Funkwhale is a web based music server. It is similar in term of goals and featur
A social platform
------------------
-However, funkwhale is better-suited for small to medium communities and was designed to be not only a music server and player, but also a place to socialize around music and discover new content. While some of these features are not currently implemented, our roadmap includes:
+However, Funkwhale is better-suited for small to medium communities and was designed to be not only a music server and player, but also a place to socialize around music and discover new content. While some of these features are not currently implemented, our roadmap includes:
- Radios, to discover the music of a given user, artist, genre...
- Playlists
diff --git a/docs/federation.rst b/docs/federation.rst
index 0f016ada9acfb1dd2942ad8cfb53b55ae56531d1..08658b12e47aec99386e3740e6939c7a76eb5254 100644
--- a/docs/federation.rst
+++ b/docs/federation.rst
@@ -22,7 +22,7 @@ Acquire music via federation
----------------------------
Instance libraries are protected by default. To access another instance
-library, you have to follow it. Each funkwhale instance gets a dedicated
+library, you have to follow it. Each Funkwhale instance gets a dedicated
ActivityPub Actor you can follow via the username "library@yourinstance.domain".
When submitted, a follow request will be sent to
diff --git a/docs/importing-music.rst b/docs/importing-music.rst
index b40eb7b88843b39eff40d2cad7d2cf6bbe91510c..76f086045aea99707b2c987f5af88e8462445044 100644
--- a/docs/importing-music.rst
+++ b/docs/importing-music.rst
@@ -4,8 +4,8 @@ Importing music
From music directory on the server
----------------------------------
-You can import music files in funkwhale assuming they are located on the server
-and readable by the funkwhale application. Your music files should contain at
+You can import music files in Funkwhale assuming they are located on the server
+and readable by the Funkwhale application. Your music files should contain at
least an ``artist``, ``album`` and ``title`` tags, but we recommend you tag
it extensively using a proper tool, such as Beets or Musicbrainz Picard.
@@ -59,7 +59,7 @@ to import and don't want to double your disk usage.
The CLI importer supports an additional ``--in-place`` option that triggers the
following behaviour during import:
-1. Imported files are not store in funkwhale anymore
+1. Imported files are not store in Funkwhale anymore
2. Instead, Funkwhale will store the file path and use it to serve the music
Because those files are not managed by Funkwhale, we offer additional
diff --git a/docs/installation/debian.rst b/docs/installation/debian.rst
index be17ab1e07aabe944389180fcef8771dfb2f3ca7..2381e4665f8f7f214fa0de3fe1ae59457fe4ad35 100644
--- a/docs/installation/debian.rst
+++ b/docs/installation/debian.rst
@@ -8,8 +8,8 @@ Debian installation
External dependencies
---------------------
-The guides will focus on installing funkwhale-specific components and
-dependencies. However, funkwhale requires a
+The guides will focus on installing Funkwhale-specific components and
+dependencies. However, Funkwhale requires a
:doc:`few external dependencies <./external_dependencies>` for which
documentation is outside of this document scope.
@@ -28,7 +28,7 @@ default on system. You can install them using:
Layout
-------
-All funkwhale-related files will be located under ``/srv/funkwhale`` apart
+All Funkwhale-related files will be located under ``/srv/funkwhale`` apart
from database files and a few configuration files. We will also have a
dedicated ``funkwhale`` user to launch the processes we need and own those files.
@@ -57,7 +57,7 @@ Now let's setup our directory layout. Here is how it will look like::
├── api # api code of your instance
├── data # persistent data, such as music files
├── front # frontend files for the web user interface
- └── virtualenv # python dependencies for funkwhale
+ └── virtualenv # python dependencies for Funkwhale
Create the aforementionned directories:
@@ -67,7 +67,7 @@ Create the aforementionned directories:
The ``virtualenv`` directory is a bit special and will be created separately.
-Download latest funkwhale release
+Download latest Funkwhale release
----------------------------------
Funkwhale is splitted in two components:
@@ -79,7 +79,7 @@ Those components are packaged in subsequent releases, such as 0.1, 0.2, etc.
You can browse the :doc:`changelog </changelog>` for a list of available releases
and pick the one you want to install, usually the latest one should be okay.
-In this guide, we'll assume you want to install the latest version of funkwhale,
+In this guide, we'll assume you want to install the latest version of Funkwhale,
which is |version|:
First, we'll download the latest api release.
@@ -113,7 +113,7 @@ First, switch to the api directory:
cd api
-A few OS packages are required in order to run funkwhale. The list is available
+A few OS packages are required in order to run Funkwhale. The list is available
in ``api/requirements.apt`` or by running
``./install_os_dependencies.sh list``.
@@ -178,7 +178,7 @@ Finally, install the python dependencies:
Environment file
----------------
-You can now start to configure funkwhale. The main way to achieve that is by
+You can now start to configure Funkwhale. The main way to achieve that is by
adding an environment file that will host settings that are relevant to your
installation.
diff --git a/docs/installation/docker.rst b/docs/installation/docker.rst
index e0520180064473d9362c85e0107f2dbdba23dad3..065cfd27e0f48f34b41bd3e54b98b60f429be07f 100644
--- a/docs/installation/docker.rst
+++ b/docs/installation/docker.rst
@@ -1,7 +1,7 @@
Docker installation
====================
-Docker is the easiest way to get a funkwhale instance up and running.
+Docker is the easiest way to get a Funkwhale instance up and running.
First, ensure you have `Docker <https://docs.docker.com/engine/installation/>`_ and `docker-compose <https://github.com/docker/compose/releases>`_ installed.
diff --git a/docs/installation/external_dependencies.rst b/docs/installation/external_dependencies.rst
index adfb90e72e9f2011dc5d3334a6c3fdfa2a3aef9e..c5cb8b3dd533cd6802921eed80f8956eb744b504 100644
--- a/docs/installation/external_dependencies.rst
+++ b/docs/installation/external_dependencies.rst
@@ -14,7 +14,7 @@ Funkwhale requires a PostgreSQL database to work properly. Please refer
to the `PostgreSQL documentation <https://www.postgresql.org/download/>`_
for installation instructions specific to your os.
-On debian-like systems, you would install the database server like this:
+On Debian-like systems, you would install the database server like this:
.. code-block:: shell
@@ -52,7 +52,7 @@ you should now be able to open a postgresql shell:
Unless you give a superuser access to the database user, you should also
enable some extensions on your database server, as those are required
-for funkwhale to work properly:
+for Funkwhale to work properly:
.. code-block:: shell
@@ -68,7 +68,7 @@ Funkwhale also requires a cache server:
queries
- To handle asynchronous tasks such as music import
-On debian-like distributions, a redis package is available, and you can
+On Debian-like distributions, a redis package is available, and you can
install it:
.. code-block:: shell
diff --git a/docs/installation/index.rst b/docs/installation/index.rst
index 83c47a101e5e7c37a7d89871c24ab985e61796ad..07da9b4ce11bf2c470e153972bceffe0f96395f6 100644
--- a/docs/installation/index.rst
+++ b/docs/installation/index.rst
@@ -96,17 +96,17 @@ Files for the web frontend are purely static and can simply be downloaded, unzip
Reverse proxy
--------------
-In order to make funkwhale accessible from outside your server and to play nicely with other applications on your machine, you should configure a reverse proxy.
+In order to make Funkwhale accessible from outside your server and to play nicely with other applications on your machine, you should configure a reverse proxy.
Nginx
^^^^^
-Ensure you have a recent version of nginx on your server. On debian-like system, you would have to run the following:
+Ensure you have a recent version of nginx on your server. On Debian-like system, you would have to run the following:
.. code-block:: bash
- apt-get update
- apt-get install nginx
+ sudo apt-get update
+ sudo apt-get install nginx
Then, download our sample virtualhost file and proxy conf:
@@ -132,7 +132,7 @@ Apache2
Ensure you have a recent version of apache2 installed on your server.
You'll also need the following dependencies::
- apt install libapache2-mod-xsendfile
+ sudo apt-get install libapache2-mod-xsendfile
Then, download our sample virtualhost file:
diff --git a/docs/installation/systemd.rst b/docs/installation/systemd.rst
index 27781c447291cfcbc0ab9279bf3eb801336ff704..f162cac7dc31fbf2960bbc5b81f46cad64a61fe1 100644
--- a/docs/installation/systemd.rst
+++ b/docs/installation/systemd.rst
@@ -1,10 +1,10 @@
Systemd configuration
----------------------
-Systemd offers a convenient way to manage your funkwhale instance if you're
+Systemd offers a convenient way to manage your Funkwhale instance if you're
not using docker.
-We'll see how to setup systemd to proprely start a funkwhale instance.
+We'll see how to setup systemd to proprely start a Funkwhale instance.
First, download the sample unitfiles:
@@ -17,9 +17,9 @@ First, download the sample unitfiles:
This will download three unitfiles:
-- ``funkwhale-server.service`` to launch the funkwhale web server
-- ``funkwhale-worker.service`` to launch the funkwhale task worker
-- ``funkwhale-beat.service`` to launch the funkwhale task beat (this is for recurring tasks)
+- ``funkwhale-server.service`` to launch the Funkwhale web server
+- ``funkwhale-worker.service`` to launch the Funkwhale task worker
+- ``funkwhale-beat.service`` to launch the Funkwhale task beat (this is for recurring tasks)
- ``funkwhale.target`` to easily stop and start all of the services at once
You can of course review and edit them to suit your deployment scenario
diff --git a/docs/upgrading.rst b/docs/upgrading.rst
index 437613b438247c347e1c0dc9d7ac0c0b25af25b3..49ea558818c894c114be0159264a6ec9de044895 100644
--- a/docs/upgrading.rst
+++ b/docs/upgrading.rst
@@ -1,4 +1,4 @@
-Upgrading your funkwhale instance to a newer version
+Upgrading your Funkwhale instance to a newer version
====================================================
.. note::
@@ -7,7 +7,7 @@ Upgrading your funkwhale instance to a newer version
the database and the media files.
We're commited to make upgrade as easy and straightforward as possible,
- however, funkwhale is still in development and you'll be safer with a backup.
+ however, Funkwhale is still in development and you'll be safer with a backup.
Reading the release notes