feat: allow comments in volunteer data

Author: vbuxbaum

README.md

@@ -18,15 +18,15 @@ arquivos estáticos, incluindo GitHub Pages.
 Os arquivos abaixo são copiados para o site sem transformação. Não é preciso
 editar HTML, CSS ou JavaScript para alterar as listas:
 
-- `data/members.json` — pessoas voluntárias, atuais e ex-voluntárias;
+- `data/members.jsonc` — pessoas voluntárias, atuais e ex-voluntárias. Aceita
+  comentários com `//`;
 - `data/posts.json` — posts do blog (opcional);
 - `data/projects.json` — projetos da comunidade (opcional);
 - `data/site.json` — textos institucionais, links e código de conduta.
 
-Depois de mudar um JSON, valide a sintaxe:
+Depois de mudar um arquivo JSON puro, valide a sintaxe:
 
 ```sh
-python3 -m json.tool data/members.json >/dev/null
 python3 -m json.tool data/projects.json >/dev/null
 ```
 

assets/js/site.js

@@ -344,12 +344,12 @@
   }
 
   async function load() {
-    const files = ['site.json', 'members.json', 'events.json', 'projects.json', 'posts.json'];
+    const files = ['site.json', 'members.jsonc', 'events.json', 'projects.json', 'posts.json'];
     try {
       const results = await Promise.all(files.map(async (file) => {
         const response = await fetch(`data/${file}`);
         if (!response.ok) throw new Error(`${file}: ${response.status}`);
-        return response.json();
+        return parseJsonc(await response.text());
       }));
       [state.site, state.members, state.events, state.projects, state.posts] = results;
       state.members = Array.isArray(state.members) ? state.members : [];
@@ -364,6 +364,41 @@
     }
   }
 
+  function parseJsonc(content) {
+    let output = '';
+    let inString = false;
+    let escaped = false;
+
+    for (let index = 0; index < content.length; index += 1) {
+      const character = content[index];
+      const nextCharacter = content[index + 1];
+
+      if (inString) {
+        output += character;
+        if (escaped) escaped = false;
+        else if (character === '\\') escaped = true;
+        else if (character === '"') inString = false;
+        continue;
+      }
+
+      if (character === '"') {
+        inString = true;
+        output += character;
+      } else if (character === '/' && nextCharacter === '/') {
+        while (index < content.length && content[index] !== '\n') index += 1;
+        output += '\n';
+      } else if (character === '/' && nextCharacter === '*') {
+        index += 2;
+        while (index < content.length && !(content[index] === '*' && content[index + 1] === '/')) index += 1;
+        index += 1;
+      } else {
+        output += character;
+      }
+    }
+
+    return JSON.parse(output);
+  }
+
   byId('language-toggle').addEventListener('click', () => { lang = lang === 'pt' ? 'en' : 'pt'; render(); });
   load();
 })();

data/members.json data/members.jsoncdata/members.json renamed to data/members.jsonc

@@ -1,3 +1,5 @@
+// Use comentários para registrar contexto sobre a lista, mas mantenha cada voluntário
+// como um objeto JSON válido.
 [
   {
     "name": "Alessandra Cioletti",
@@ -8,7 +10,7 @@
     "linkedin": "https://www.linkedin.com/in/allanadcardoso/"
   },
   {
-    "name": "Anna S.",
+    "name": "Anna Luiza",
     "linkedin": "https://www.linkedin.com/in/anna-s-b0680b2b3/"
   },
   {
@@ -19,27 +21,27 @@
     "name": "Cássio Botaro",
     "github": "cassiobotaro",
     "twitter": "@cassiobotaro",
-    "email": "cassiobotaro@gmail.com",
+    // "email": "cassiobotaro@gmail.com",
     "site": { "nome": "Import None", "href": "https://cassiobotaro.github.io" }
   },
   {
-    "name": "Daniel Canesso Bicalho",
+    "name": "Daniel Bicalho",
     "linkedin": "https://www.linkedin.com/in/daniel-canesso/"
   },
   {
     "name": "Débora Thomaz",
     "linkedin": "https://www.linkedin.com/in/dmthomaz/"
   },
   {
-    "name": "Diego Ascanio Santos",
+    "name": "Diego Ascanio",
     "linkedin": "https://www.linkedin.com/in/diego-ascanio-santos-02b674210/"
   },
   {
-    "name": "Iago P. Ferreira",
+    "name": "Iago Ferreira",
     "linkedin": "https://www.linkedin.com/in/iago-p-ferreira/"
   },
   {
-    "name": "Jean",
+    "name": "Jean Oliveira",
     "linkedin": "https://www.linkedin.com/in/jean3/"
   },
   {