diff --git a/languages/fr-FR-help.lang.json b/languages/fr-FR-help.lang.json
index 7509b8be..3ccd974a 100644
--- a/languages/fr-FR-help.lang.json
+++ b/languages/fr-FR-help.lang.json
@@ -1,6 +1,6 @@
 {
-  "= Help Topics =\n\nCommands:\n%[1]s\n\nRPL_ISUPPORT Tokens:\n%[2]s\n\nInformation:\n%[3]s": "",
-  "== Channel Modes ==\n\nOragono supports the following channel modes:\n\n  +b  |  Client masks that are banned from the channel (e.g. *!*@127.0.0.1)\n  +e  |  Client masks that are exempted from bans.\n  +I  |  Client masks that are exempted from the invite-only flag.\n  +i  |  Invite-only mode, only invited clients can join the channel.\n  +k  |  Key required when joining the channel.\n  +l  |  Client join limit for the channel.\n  +m  |  Moderated mode, only privileged clients can talk on the channel.\n  +n  |  No-outside-messages mode, only users that are on the channel can send\n      |  messages to it.\n  +R  |  Only registered users can talk in the channel.\n  +s  |  Secret mode, channel won't show up in /LIST or whois replies.\n  +t  |  Only channel opers can modify the topic.\n\n= Prefixes =\n\n  +q (~)  |  Founder channel mode.\n  +a (&)  |  Admin channel mode.\n  +o (@)  |  Operator channel mode.\n  +h (%)  |  Halfop channel mode.\n  +v (+)  |  Voice channel mode.": "",
+  "= Help Topics =\n\nCommands:\n%[1]s\n\nRPL_ISUPPORT Tokens:\n%[2]s\n\nInformation:\n%[3]s": "= Sujets d’aide =\n\nCommandes :\n%[1]s\n\nJetons RPL_ISUPPORT :\n%[2]s\n\nInformation :\n%[3]s",
+  "== Channel Modes ==\n\nOragono supports the following channel modes:\n\n  +b  |  Client masks that are banned from the channel (e.g. *!*@127.0.0.1)\n  +e  |  Client masks that are exempted from bans.\n  +I  |  Client masks that are exempted from the invite-only flag.\n  +i  |  Invite-only mode, only invited clients can join the channel.\n  +k  |  Key required when joining the channel.\n  +l  |  Client join limit for the channel.\n  +m  |  Moderated mode, only privileged clients can talk on the channel.\n  +n  |  No-outside-messages mode, only users that are on the channel can send\n      |  messages to it.\n  +R  |  Only registered users can talk in the channel.\n  +s  |  Secret mode, channel won't show up in /LIST or whois replies.\n  +t  |  Only channel opers can modify the topic.\n\n= Prefixes =\n\n  +q (~)  |  Founder channel mode.\n  +a (&)  |  Admin channel mode.\n  +o (@)  |  Operator channel mode.\n  +h (%)  |  Halfop channel mode.\n  +v (+)  |  Voice channel mode.": "== Modes de Salon ==\n\nOragono propose les modes de salon suivants :\n\n  +b  |  Masques bannis (i.e. *!*@127.0.0.1).\n  +e  |  Masques immunisés au bannissement.\n  +I   |  Masques exemptés d’invitation.\n  +i   |  Invitation requise.\n  +k  |  Clé requise.\n  +l   |  Places limitées.\n  +m |  Seul·e·s les utilisateurices privilégié·e·s peuvent intervenir.\n  +n  |  Aucun message extérieur, seul·e·s les utilisateurices présent·e·s peuvent intervenir.\n  +R  |  Seul·e·s les utilisateurices enregistré·e·s peuvent intervenir.\n  +s  |  Secret, le salon n’apparaît pas via /list ou /whois.\n  +t   |  Seul·e·s les opérateurices peuvent changer le sujet.\n\n= Préfixes =\n\n  +q (~)  |  Fondateurice.\n  +a (&)  |  Administrateurice.\n  +o (@) |  Opérateurice.\n  +h (%) |  Modérateurice.\n  +v (+)  |  Utilisateurice voisé·e.",
   "== Server Notice Masks ==\n\nOragono supports the following server notice masks for operators:\n\n  a  |  Local announcements.\n  c  |  Local client connections.\n  j  |  Local channel actions.\n  k  |  Local kills.\n  n  |  Local nick changes.\n  o  |  Local oper actions.\n  q  |  Local quits.\n  t  |  Local /STATS usage.\n  u  |  Local client account actions.\n  x  |  Local X-lines (DLINE/KLINE/etc).\n\nTo set a snomask, do this with your nickname:\n\n  /MODE <nick> +s <chars>\n\nFor instance, this would set the kill, oper, account and xline snomasks on dan:\n\n  /MODE dan +s koux": "",
   "== User Modes ==\n\nOragono supports the following user modes:\n\n  +a  |  User is marked as being away. This mode is set with the /AWAY command.\n  +i  |  User is marked as invisible (their channels are hidden from whois replies).\n  +o  |  User is an IRC operator.\n  +R  |  User only accepts messages from other registered users. \n  +s  |  Server Notice Masks (see help with /HELPOP snomasks).\n  +Z  |  User is connected via TLS.": "",
   "@+client-only-tags TAGMSG <target>{,<target>}\n\nSends the given client-only tags to the given targets as a TAGMSG. See the IRCv3\nspecs for more info: http://ircv3.net/specs/core/message-tags-3.3.html": "",
@@ -16,7 +16,7 @@
   "DEBUG <option>\n\nPrints debug information about the IRCd. <option> can be one of:\n\n* GCSTATS: Garbage control statistics.\n* NUMGOROUTINE: Number of goroutines in use.\n* STARTCPUPROFILE: Starts the CPU profiler.\n* STOPCPUPROFILE: Stops the CPU profiler.\n* PROFILEHEAP: Writes out the CPU profiler info.": "",
   "DLINE [ANDKILL] [MYSELF] [duration] <ip>/<net> [ON <server>] [reason [| oper reason]]\nDLINE LIST\n\nBans an IP address or network from connecting to the server. If the duration is\ngiven then only for that long. The reason is shown to the user themselves, but\neveryone else will see a standard message. The oper reason is shown to\noperators getting info about the DLINEs that exist.\n\nBans are saved across subsequent launches of the server.\n\n\"ANDKILL\" means that all matching clients are also removed from the server.\n\n\"MYSELF\" is required when the DLINE matches the address the person applying it is connected\nfrom. If \"MYSELF\" is not given, trying to DLINE yourself will result in an error.\n\n[duration] can be of the following forms:\n\t1y 12mo 31d 10h 8m 13s\n\n<net> is specified in typical CIDR notation. For example:\n\t127.0.0.1/8\n\t8.8.8.8/24\n\nON <server> specifies that the ban is to be set on that specific server.\n\n[reason] and [oper reason], if they exist, are separated by a vertical bar (|).\n\nIf \"DLINE LIST\" is sent, the server sends back a list of our current DLINEs.": "",
   "HELP <argument>\n\nGet an explanation of <argument>, or \"index\" for a list of help topics.": "",
-  "HELPOP <argument>\n\nGet an explanation of <argument>, or \"index\" for a list of help topics.": "",
+  "HELPOP <argument>\n\nGet an explanation of <argument>, or \"index\" for a list of help topics.": "HELPOP <commande>\n\nExplique la commande donnée ; une liste complète est disponible via « /helpop index ».",
   "HISTORY <target> [limit]\n\nReplay message history. <target> can be a channel name, \"me\" to replay direct\nmessage history, or a nickname to replay another client's direct message\nhistory (they must be logged into the same account as you). At most [limit]\nmessages will be replayed.": "",
   "HOSTSERV <command> [params]\n\nHostServ lets you manage your vhost (a string displayed in place of your\nreal hostname).": "",
   "HS <command> [params]\n\nHostServ lets you manage your vhost (a string displayed in place of your\nreal hostname).": "",
diff --git a/languages/fr-FR.lang.yaml b/languages/fr-FR.lang.yaml
index 0a611988..b628625e 100644
--- a/languages/fr-FR.lang.yaml
+++ b/languages/fr-FR.lang.yaml
@@ -1,5 +1,15 @@
 ---
+#translation info file for our example language
+#languages are made up of a few different files:
+#<locale>.lang.yaml       - general info about the translation
+#<locale>-irc.lang.json   - IRC strings to be translated
+#<locale>-help.lang.json  - help entries to be translated
+#we split up translations in this way so that they can be displayed more nicely on CrowdIn
+#name - this is the 'nice' or 'full' name of the language
 name: "Français"
+#code - this is what the language will be referred to in our list of languages
 code: "fr-FR"
+#contributors - people who have contributed to this translation
 contributors: "Joshua Kwan <joshk@triplehelix.org>, Nuve"
+#incomplete - whether to mark this language as incomplete
 incomplete: true