From 91bcf56fa598201f3c2c9608a030d6beaa56108c Mon Sep 17 00:00:00 2001 From: marcelo-m7 Date: Sat, 8 Nov 2025 16:34:38 +0000 Subject: [PATCH 1/3] Refactor documentation structure: remove legacy sections and update project links - Deleted outdated contributor documentation and guides. - Removed legacy category files for guides, contributors, and other topics. - Updated project documentation paths from Portuguese to English. - Added new project documentation for ArtLeo Creative Spaces, Boteco.pt, FACODI, Monynha.com, Monynha Online, MonynhaTech, and Sweet Price. - Consolidated technology documentation, including CI/CD, Convex, Coolify, Docker Compose, Flutter, GitHub Actions, and TypeScript. - Ensured all links in the sidebar and navigation reflect the new structure. --- docs/contribuicao/_category_.json | 4 ---- docs/contribuicao/index.md | 9 ------- docs/guias/_category_.json | 4 ---- docs/guias/index.md | 9 ------- docs/outros/_category_.json | 4 ---- docs/outros/index.md | 9 ------- docs/padroes/_category_.json | 4 ---- docs/padroes/code-style/index.md | 23 ------------------ docs/projects/_category_.json | 6 ++--- .../artleo-creative-spaces/index.md | 13 +++++----- docs/projects/boteco-pro.md | 6 ++--- docs/projects/boteco-pt/index.md | 19 +++++++++++++++ docs/projects/facodi/index.md | 19 +++++++++++++++ docs/projects/monynha-com/index.md | 19 +++++++++++++++ docs/projects/monynha-online/index.md | 18 ++++++++++++++ .../monynha-tech/index.md | 12 +++++----- .../sweet-price/index.md | 14 +++++------ docs/projetos/_category_.json | 4 ---- docs/projetos/boteco-pro/index.md | 20 ---------------- docs/projetos/boteco-pt/index.md | 18 -------------- docs/projetos/facodi/index.md | 18 -------------- docs/projetos/monynha-com/index.md | 19 --------------- docs/projetos/monynha-online/index.md | 18 -------------- .../ci-cd/index.md | 0 .../convex/index.md | 0 .../coolify/index.md | 0 .../docker-compose/index.md | 0 .../flutter/index.md | 0 .../github-actions/index.md | 0 docs/technologies/typescript/index.md | 24 +++++++++++++++++++ docs/tecnologias/_category_.json | 4 ---- docs/tecnologias/typescript/index.md | 20 ---------------- docusaurus.config.js | 5 ++-- sidebars.js | 16 ++++++------- src/components/Portfolio/index.js | 2 +- 35 files changed, 136 insertions(+), 224 deletions(-) delete mode 100644 docs/contribuicao/_category_.json delete mode 100644 docs/contribuicao/index.md delete mode 100644 docs/guias/_category_.json delete mode 100644 docs/guias/index.md delete mode 100644 docs/outros/_category_.json delete mode 100644 docs/outros/index.md delete mode 100644 docs/padroes/_category_.json delete mode 100644 docs/padroes/code-style/index.md rename docs/{projetos => projects}/artleo-creative-spaces/index.md (50%) create mode 100644 docs/projects/boteco-pt/index.md create mode 100644 docs/projects/facodi/index.md create mode 100644 docs/projects/monynha-com/index.md create mode 100644 docs/projects/monynha-online/index.md rename docs/{projetos => projects}/monynha-tech/index.md (51%) rename docs/{projetos => projects}/sweet-price/index.md (52%) delete mode 100644 docs/projetos/_category_.json delete mode 100644 docs/projetos/boteco-pro/index.md delete mode 100644 docs/projetos/boteco-pt/index.md delete mode 100644 docs/projetos/facodi/index.md delete mode 100644 docs/projetos/monynha-com/index.md delete mode 100644 docs/projetos/monynha-online/index.md rename docs/{tecnologias => technologies}/ci-cd/index.md (100%) rename docs/{tecnologias => technologies}/convex/index.md (100%) rename docs/{tecnologias => technologies}/coolify/index.md (100%) rename docs/{tecnologias => technologies}/docker-compose/index.md (100%) rename docs/{tecnologias => technologies}/flutter/index.md (100%) rename docs/{tecnologias => technologies}/github-actions/index.md (100%) create mode 100644 docs/technologies/typescript/index.md delete mode 100644 docs/tecnologias/_category_.json delete mode 100644 docs/tecnologias/typescript/index.md diff --git a/docs/contribuicao/_category_.json b/docs/contribuicao/_category_.json deleted file mode 100644 index 77dd622..0000000 --- a/docs/contribuicao/_category_.json +++ /dev/null @@ -1,4 +0,0 @@ -{ - "label": "Documentação para Contribuidores", - "position": 6 -} \ No newline at end of file diff --git a/docs/contribuicao/index.md b/docs/contribuicao/index.md deleted file mode 100644 index 8be94a1..0000000 --- a/docs/contribuicao/index.md +++ /dev/null @@ -1,9 +0,0 @@ -# Documentação para Contribuidores - -Esta seção contém informações sobre como contribuir com os projetos da Monynha. - -## Conteúdo em breve - -- Como contribuir -- Processo de PR -- Código de conduta diff --git a/docs/guias/_category_.json b/docs/guias/_category_.json deleted file mode 100644 index 5a18792..0000000 --- a/docs/guias/_category_.json +++ /dev/null @@ -1,4 +0,0 @@ -{ - "label": "Guias e Boas Práticas", - "position": 5 -} \ No newline at end of file diff --git a/docs/guias/index.md b/docs/guias/index.md deleted file mode 100644 index 35e29ec..0000000 --- a/docs/guias/index.md +++ /dev/null @@ -1,9 +0,0 @@ -# Guias e Boas Práticas - -Esta seção contém guias e melhores práticas para desenvolvimento na Monynha. - -## Conteúdo em breve - -- Guia de deploy -- Melhores práticas de código -- Tutoriais \ No newline at end of file diff --git a/docs/outros/_category_.json b/docs/outros/_category_.json deleted file mode 100644 index b4f42af..0000000 --- a/docs/outros/_category_.json +++ /dev/null @@ -1,4 +0,0 @@ -{ - "label": "Outros Temas", - "position": 7 -} \ No newline at end of file diff --git a/docs/outros/index.md b/docs/outros/index.md deleted file mode 100644 index c7ee5de..0000000 --- a/docs/outros/index.md +++ /dev/null @@ -1,9 +0,0 @@ -# Outros Temas - -Esta seção contém tópicos diversos relacionados aos projetos da Monynha. - -## Conteúdo em breve - -- UX e Design -- Acessibilidade -- Dados e Analytics \ No newline at end of file diff --git a/docs/padroes/_category_.json b/docs/padroes/_category_.json deleted file mode 100644 index b70cf32..0000000 --- a/docs/padroes/_category_.json +++ /dev/null @@ -1,4 +0,0 @@ -{ - "label": "Padrões Internos", - "position": 4 -} \ No newline at end of file diff --git a/docs/padroes/code-style/index.md b/docs/padroes/code-style/index.md deleted file mode 100644 index 03713f8..0000000 --- a/docs/padroes/code-style/index.md +++ /dev/null @@ -1,23 +0,0 @@ -# Estilo de Código - -## Convenções Gerais - -- Use camelCase para variáveis e funções em JavaScript/TypeScript. -- Use PascalCase para classes e componentes. -- Indentação: 2 espaços. -- Linhas não devem exceder 80 caracteres. - -## TypeScript Específico - -- Sempre use tipos explícitos para parâmetros e retornos de função. -- Evite `any`; use tipos específicos. - -## Flutter/Dart - -- Use snake_case para nomes de arquivos. -- Seguir as convenções do Dart. - -## Ferramentas - -- ESLint para JavaScript/TypeScript -- Dartfmt para Dart \ No newline at end of file diff --git a/docs/projects/_category_.json b/docs/projects/_category_.json index c2b01dc..4ad7d4f 100644 --- a/docs/projects/_category_.json +++ b/docs/projects/_category_.json @@ -1,8 +1,8 @@ { - "label": "Projects (legacy)", - "position": 99, + "label": "Projects", + "position": 2, "link": { "type": "generated-index", - "description": "LEGACY: Duplicate/legacy English project pages. Prefer /docs/projetos/* (Portuguese)." + "description": "Documentation for Monynha Softwares projects: overviews, tech stacks, and guides." } } \ No newline at end of file diff --git a/docs/projetos/artleo-creative-spaces/index.md b/docs/projects/artleo-creative-spaces/index.md similarity index 50% rename from docs/projetos/artleo-creative-spaces/index.md rename to docs/projects/artleo-creative-spaces/index.md index 80b6c19..cead2dd 100644 --- a/docs/projetos/artleo-creative-spaces/index.md +++ b/docs/projects/artleo-creative-spaces/index.md @@ -1,18 +1,19 @@ # ArtLeo Creative Spaces -## Descrição +## Description Art by Monynha -## Tecnologias Utilizadas +## Technologies - TypeScript -## Repositório +## Repository [GitHub: artleo-creative-spaces](https://github.com/Monynha-Softwares/artleo-creative-spaces) -## Funcionalidades +## Features + +- Creative and artistic spaces platform +- Platform for artistic expression -- Espaços criativos e artísticos -- Plataforma para expressão artística \ No newline at end of file diff --git a/docs/projects/boteco-pro.md b/docs/projects/boteco-pro.md index 5ad827f..3af1751 100644 --- a/docs/projects/boteco-pro.md +++ b/docs/projects/boteco-pro.md @@ -3,13 +3,13 @@ title: "Boteco Pro — Project Overview" sidebar_position: 1 --- -This page is retained for compatibility. The canonical project documentation now lives under the Portuguese `projetos` section. +This compatibility page points to the canonical project documentation under the `projects` section. Please visit the canonical page for Boteco Pro: -[Boteco Pro — Página principal](/docs/projetos/boteco-pro) +[Boteco Pro — Project Page](/docs/projects/boteco-pro) -If you maintain docs links that point to `/docs/projects/*`, consider updating them to `/docs/projetos/*`. +If you maintain docs links that point to `/docs/projetos/*`, consider updating them to `/docs/projects/*`. ### Planned diff --git a/docs/projects/boteco-pt/index.md b/docs/projects/boteco-pt/index.md new file mode 100644 index 0000000..69cbb2e --- /dev/null +++ b/docs/projects/boteco-pt/index.md @@ -0,0 +1,19 @@ +# Boteco.pt + +## Description + +Boteco Pro: Complete solution for bars and restaurants. + +## Technologies + +- TypeScript + +## Repository + +[GitHub: boteco.pt](https://github.com/Monynha-Softwares/boteco.pt) + +## Features + +- Full management system for bars and restaurants +- Integrated solutions for the hospitality sector + diff --git a/docs/projects/facodi/index.md b/docs/projects/facodi/index.md new file mode 100644 index 0000000..d37ba77 --- /dev/null +++ b/docs/projects/facodi/index.md @@ -0,0 +1,19 @@ +# FACODI + +## Description + +FACODI — Community Digital College — https://facodi.pt + +## Technologies + +- Python + +## Repository + +[GitHub: facodi.pt](https://github.com/Monynha-Softwares/facodi.pt) + +## Features + +- Community educational platform +- Digital learning resources + diff --git a/docs/projects/monynha-com/index.md b/docs/projects/monynha-com/index.md new file mode 100644 index 0000000..e6d7af4 --- /dev/null +++ b/docs/projects/monynha-com/index.md @@ -0,0 +1,19 @@ +# Monynha.com + +## Description + +Monynha Softwares' institutional website — tailor-made software and AI solutions. + +## Technologies + +- TypeScript +- Next.js (likely) + +## Repository + +[GitHub: Monynha-com](https://github.com/Monynha-Softwares/Monynha-com) + +## Features + +- Institutional website +- Presentation of software and AI solutions diff --git a/docs/projects/monynha-online/index.md b/docs/projects/monynha-online/index.md new file mode 100644 index 0000000..7213833 --- /dev/null +++ b/docs/projects/monynha-online/index.md @@ -0,0 +1,18 @@ +# Monynha Online + +## Description + +https://monynha.online + +## Technologies + +- TypeScript + +## Repository + +[GitHub: MonynhaOnline-Default-Page](https://github.com/Monynha-Softwares/MonynhaOnline-Default-Page) + +## Features + +- Default online presence for Monynha +- Digital presence diff --git a/docs/projetos/monynha-tech/index.md b/docs/projects/monynha-tech/index.md similarity index 51% rename from docs/projetos/monynha-tech/index.md rename to docs/projects/monynha-tech/index.md index 89369e4..ab21bed 100644 --- a/docs/projetos/monynha-tech/index.md +++ b/docs/projects/monynha-tech/index.md @@ -1,18 +1,18 @@ # MonynhaTech -## Descrição +## Description [https://monynha.tech](https://monynha.tech) -## Tecnologias Utilizadas +## Technologies - TypeScript -## Repositório +## Repository [GitHub: MonynhaTech](https://github.com/Monynha-Softwares/MonynhaTech) -## Funcionalidades +## Features -- Plataforma tecnológica da Monynha -- Recursos e ferramentas tech \ No newline at end of file +- Monynha technology platform +- Tools and resources for developers diff --git a/docs/projetos/sweet-price/index.md b/docs/projects/sweet-price/index.md similarity index 52% rename from docs/projetos/sweet-price/index.md rename to docs/projects/sweet-price/index.md index 6e6cc71..f69b400 100644 --- a/docs/projetos/sweet-price/index.md +++ b/docs/projects/sweet-price/index.md @@ -1,18 +1,18 @@ # Sweet Price -## Descrição +## Description Supermarket price comparison app in Portugal. Currently supports: Pingo Doce and Continente supermarkets. -## Tecnologias Utilizadas +## Technologies -- (A definir) +- (TBD) -## Repositório +## Repository [GitHub: Sweet-Price](https://github.com/Monynha-Softwares/Sweet-Price) -## Funcionalidades +## Features -- Comparação de preços em supermercados portugueses -- Suporte para Pingo Doce e Continente \ No newline at end of file +- Price comparison for Portuguese supermarkets +- Support for Pingo Doce and Continente diff --git a/docs/projetos/_category_.json b/docs/projetos/_category_.json deleted file mode 100644 index 50e4af1..0000000 --- a/docs/projetos/_category_.json +++ /dev/null @@ -1,4 +0,0 @@ -{ - "label": "Projetos", - "position": 2 -} \ No newline at end of file diff --git a/docs/projetos/boteco-pro/index.md b/docs/projetos/boteco-pro/index.md deleted file mode 100644 index 19b1137..0000000 --- a/docs/projetos/boteco-pro/index.md +++ /dev/null @@ -1,20 +0,0 @@ -# Boteco Pro - -## Descrição - -Sistema completo de gestão para bares e restaurantes com autenticação Firebase, banco de dados e interface Flutter moderna. - -## Tecnologias Utilizadas - -- Flutter (Dart) -- Firebase (Autenticação e Banco de Dados) - -## Repositório - -[GitHub: BotecoPro](https://github.com/Monynha-Softwares/BotecoPro) - -## Funcionalidades - -- Gestão de pedidos -- Autenticação de usuários -- Interface moderna para bares e restaurantes \ No newline at end of file diff --git a/docs/projetos/boteco-pt/index.md b/docs/projetos/boteco-pt/index.md deleted file mode 100644 index 3dd291f..0000000 --- a/docs/projetos/boteco-pt/index.md +++ /dev/null @@ -1,18 +0,0 @@ -# Boteco.pt - -## Descrição - -Boteco Pro: A Solução Completa para Bares e Restaurantes - -## Tecnologias Utilizadas - -- TypeScript - -## Repositório - -[GitHub: boteco.pt](https://github.com/Monynha-Softwares/boteco.pt) - -## Funcionalidades - -- Sistema completo para gestão de bares e restaurantes -- Soluções integradas para o setor diff --git a/docs/projetos/facodi/index.md b/docs/projetos/facodi/index.md deleted file mode 100644 index 5aa6cb5..0000000 --- a/docs/projetos/facodi/index.md +++ /dev/null @@ -1,18 +0,0 @@ -# FACODI - -## Descrição - -📝 FACODI — Faculdade Comunitária Digital — [https://facodi.pt](https://facodi.pt) - -## Tecnologias Utilizadas - -- Python - -## Repositório - -[GitHub: facodi.pt](https://github.com/Monynha-Softwares/facodi.pt) - -## Funcionalidades - -- Plataforma educacional comunitária -- Recursos digitais para aprendizagem \ No newline at end of file diff --git a/docs/projetos/monynha-com/index.md b/docs/projetos/monynha-com/index.md deleted file mode 100644 index ec0a5e3..0000000 --- a/docs/projetos/monynha-com/index.md +++ /dev/null @@ -1,19 +0,0 @@ -# Monynha.com - -## Descrição - -🌐 Monynha Softwares's institutional website — tailor-made software and artificial intelligence solutions. - -## Tecnologias Utilizadas - -- TypeScript -- Next.js (provavelmente) - -## Repositório - -[GitHub: Monynha-com](https://github.com/Monynha-Softwares/Monynha-com) - -## Funcionalidades - -- Website institucional -- Apresentação de soluções de software e IA diff --git a/docs/projetos/monynha-online/index.md b/docs/projetos/monynha-online/index.md deleted file mode 100644 index 17e51b0..0000000 --- a/docs/projetos/monynha-online/index.md +++ /dev/null @@ -1,18 +0,0 @@ -# Monynha Online - -## Descrição - -[https://monynha.online](https://monynha.online) - -## Tecnologias Utilizadas - -- TypeScript - -## Repositório - -[GitHub: MonynhaOnline-Default-Page](https://github.com/Monynha-Softwares/MonynhaOnline-Default-Page) - -## Funcionalidades - -- Página padrão online da Monynha -- Presença digital \ No newline at end of file diff --git a/docs/tecnologias/ci-cd/index.md b/docs/technologies/ci-cd/index.md similarity index 100% rename from docs/tecnologias/ci-cd/index.md rename to docs/technologies/ci-cd/index.md diff --git a/docs/tecnologias/convex/index.md b/docs/technologies/convex/index.md similarity index 100% rename from docs/tecnologias/convex/index.md rename to docs/technologies/convex/index.md diff --git a/docs/tecnologias/coolify/index.md b/docs/technologies/coolify/index.md similarity index 100% rename from docs/tecnologias/coolify/index.md rename to docs/technologies/coolify/index.md diff --git a/docs/tecnologias/docker-compose/index.md b/docs/technologies/docker-compose/index.md similarity index 100% rename from docs/tecnologias/docker-compose/index.md rename to docs/technologies/docker-compose/index.md diff --git a/docs/tecnologias/flutter/index.md b/docs/technologies/flutter/index.md similarity index 100% rename from docs/tecnologias/flutter/index.md rename to docs/technologies/flutter/index.md diff --git a/docs/tecnologias/github-actions/index.md b/docs/technologies/github-actions/index.md similarity index 100% rename from docs/tecnologias/github-actions/index.md rename to docs/technologies/github-actions/index.md diff --git a/docs/technologies/typescript/index.md b/docs/technologies/typescript/index.md new file mode 100644 index 0000000..db58be4 --- /dev/null +++ b/docs/technologies/typescript/index.md @@ -0,0 +1,24 @@ +--- +title: TypeScript +--- + +## Description + +TypeScript is a superset of JavaScript that adds optional static typing. It helps catch errors earlier and improves code readability and maintainability. + +## Why we use it + +- Better maintainability +- Compile-time error detection +- Improved IDE and editor support (autocompletion, refactorings) + +## Projects that use TypeScript + +- Monynha-com +- Several web projects in this repo + +## Resources + +- [TypeScript Official Docs](https://www.typescriptlang.org/docs/) + +If you previously referenced `/docs/tecnologias/typescript`, the Portuguese content remains under that path — this English page is a compatibility stub to ensure internal links to `/docs/technologies/typescript` resolve correctly. diff --git a/docs/tecnologias/_category_.json b/docs/tecnologias/_category_.json deleted file mode 100644 index 3743b39..0000000 --- a/docs/tecnologias/_category_.json +++ /dev/null @@ -1,4 +0,0 @@ -{ - "label": "Tecnologias", - "position": 3 -} \ No newline at end of file diff --git a/docs/tecnologias/typescript/index.md b/docs/tecnologias/typescript/index.md deleted file mode 100644 index 0f80c48..0000000 --- a/docs/tecnologias/typescript/index.md +++ /dev/null @@ -1,20 +0,0 @@ -# TypeScript - -## Descrição - -TypeScript é uma linguagem de programação que é um superconjunto de JavaScript, adicionando tipagem estática opcional. - -## Por que usamos - -- Melhor manutenção de código -- Detecção de erros em tempo de desenvolvimento -- Melhor suporte a IDEs - -## Projetos que utilizam - -- Monynha-com -- Vários outros projetos web - -## Recursos - -- [Documentação Oficial](https://www.typescriptlang.org/docs/) \ No newline at end of file diff --git a/docusaurus.config.js b/docusaurus.config.js index cfbb118..cdb40e4 100644 --- a/docusaurus.config.js +++ b/docusaurus.config.js @@ -98,7 +98,6 @@ const config = { position: 'left', items: [ { to: '/docs/intro', label: 'Introdução' }, - { to: '/docs/projetos/boteco-pro', label: 'Projetos' }, { to: '/docs/technologies/frontend-stack', label: 'Tecnologias' }, { to: '/docs/guidelines/ux-guidelines', label: 'Guidelines' }, { to: '/docs/identity/brand-guidelines', label: 'Identidade' }, @@ -135,11 +134,11 @@ const config = { }, { label: 'Projetos', - to: '/docs/projetos/boteco-pro', + to: '/docs/projects/boteco-pro', }, { label: 'Tecnologias', - to: '/docs/tecnologias/typescript', + to: '/docs/technologies/typescript', }, ], }, diff --git a/sidebars.js b/sidebars.js index 74552ae..6167ff3 100644 --- a/sidebars.js +++ b/sidebars.js @@ -26,14 +26,14 @@ const sidebars = { description: 'Documentação dos projetos Monynha (visões gerais, stacks e guias).', }, items: [ - 'projetos/boteco-pro/index', - 'projetos/artleo-creative-spaces/index', - 'projetos/boteco-pt/index', - 'projetos/facodi/index', - 'projetos/monynha-com/index', - 'projetos/monynha-online/index', - 'projetos/monynha-tech/index', - 'projetos/sweet-price/index' + 'projects/boteco-pro/index', + 'projects/artleo-creative-spaces/index', + 'projects/boteco-pt/index', + 'projects/facodi/index', + 'projects/monynha-com/index', + 'projects/monynha-online/index', + 'projects/monynha-tech/index', + 'projects/sweet-price/index' ] }, { diff --git a/src/components/Portfolio/index.js b/src/components/Portfolio/index.js index 3bc50bb..2c483fb 100644 --- a/src/components/Portfolio/index.js +++ b/src/components/Portfolio/index.js @@ -9,7 +9,7 @@ const projects = [ description: 'Sistema completo de gestão para bares e restaurantes com controle de pedidos, estoque e financeiro.', technologies: ['Flutter', 'TypeScript', 'Convex'], status: 'Em Desenvolvimento', - link: '/docs/projetos/boteco-pro', + link: '/docs/projects/boteco-pro', icon: '🍺', color: '#FF6B35' }, From 97a1415b5f831d670ba306ed5bb1e7add7e996db Mon Sep 17 00:00:00 2001 From: marcelo-m7 Date: Sat, 8 Nov 2025 16:36:38 +0000 Subject: [PATCH 2/3] refactor: streamline AI coding agent instructions for clarity and usability --- .github/copilot-instructions.md | 126 +++++++++++--------------------- 1 file changed, 44 insertions(+), 82 deletions(-) diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md index 79aadb3..81ea4c6 100644 --- a/.github/copilot-instructions.md +++ b/.github/copilot-instructions.md @@ -1,84 +1,46 @@ -## Purpose - -This file provides repository-specific guidance to AI coding agents for working effectively on the Docusaurus documentation site in this repository. - -## Big Picture - -- This project is a Docusaurus v3 site (see `docusaurus.config.js`) using the classic preset. Content is organized into `docs/` (documentation) and `blog/` (posts). React UI components are in `src/`, and static assets are in `static/`. -- Primary responsibilities include running the dev server, authoring docs/blog posts (Markdown/MDX), updating UI components/styles, managing sidebar/category metadata, and building/deploying the site. - -## Key Files & Folders - -- `package.json`: Contains scripts for development (`start`), production builds (`build`), serving builds (`serve`), and deployment (`deploy`). Node >= 20 is required. -- `docusaurus.config.js`: Global site configuration (e.g., `baseUrl`, `organizationName`, `projectName`, `editUrl`, navbar/footer settings). -- `sidebars.js`: Controls the docs sidebar. Update this file when adding/moving docs or categories. -- `docs/`: Markdown/MDX documentation. Subfolders use `_category_.json` for grouping (e.g., `docs/tutorial-basics/_category_.json`). -- `blog/`: Blog posts (Markdown/MDX) with metadata in `authors.yml` and `tags.yml`. -- `src/components/`: Custom React components (e.g., `HomepageFeatures`, `TechStack`, `Portfolio`). -- `src/css/custom.css`: Global styling. Page-specific styles are in `src/pages`. -- `static/img/` and `docs/**/img/`: Image assets. Use `static/img/` for global assets and relative `./img/...` for doc-specific images. - -## Development Commands - -1. Install dependencies: - - ```powershell - yarn - ``` - -2. Run the development server (hot reload; default port 3000): - - ```powershell - yarn start - ``` - -3. Build and preview production: - - ```powershell - yarn build - yarn serve - ``` - -4. Deploy to GitHub Pages: - - ```powershell - USE_SSH=true; yarn deploy - # or without SSH - GIT_USER=; yarn deploy - ``` - -## Project-Specific Conventions & Patterns - -- **Docs Grouping**: Each `docs/` subfolder may include `_category_.json` for grouping. Update `sidebars.js` if moving docs. -- **Images**: Place global images in `static/img/` and per-doc images in `img/` next to the doc file. Reference them via `./img/foo.png` in Markdown. -- **UI Components**: Reusable components are in `src/components/`. Follow existing patterns in `src/css/custom.css` and `src/components/*/styles.module.css`. -- **MDX Usage**: Use MDX for embedding React components in docs/blogs. Examples are in `docs/` and `blog/`. - -## Integration Points & External Dependencies - -- **Docusaurus Packages**: Check `package.json` for dependencies. Avoid adding heavy runtime-only dependencies unless necessary. -- **Deployment**: GitHub Pages is the default deploy target. Ensure `organizationName` and `projectName` in `docusaurus.config.js` match the repo/org. -- **CI/CD**: No CI configuration exists. If adding CI (e.g., GitHub Actions), ensure Node >= 20 and include `yarn install && yarn build` steps. - -## Examples of Common Changes - -- **Add a Doc**: Create `docs/
/new-doc.md` (or `.mdx`) and update `sidebars.js` or rely on automatic sidebar paths. -- **Add a Blog Post**: Create `blog/YYYY-MM-DD-title.md` with YAML frontmatter (e.g., `title`, `tags`, `authors`). Update `blog/authors.yml` for new authors. -- **Edit Homepage Features**: Modify `src/components/HomepageFeatures/index.js` and `src/components/HomepageFeatures/styles.module.css`. Use `yarn start` to hot-reload. - -## Notes & Watch-Outs - -- **Node Environment**: Docusaurus config runs in Node.js. Avoid browser-specific code (e.g., `window`, `document`). -- **Version Compatibility**: The repo uses Docusaurus v3 with `future.v4: true`. Test thoroughly before upgrading to v4. -- **Testing**: No automated tests exist. Validate changes locally with `yarn build && yarn serve`. - -## Contribution Guidelines - +## MonaDocs AI Coding Agent Instructions + +This guide enables AI coding agents to work productively in the MonaDocs Docusaurus v3 documentation site. It summarizes essential architecture, workflows, and conventions unique to this codebase. + +### Big Picture Architecture +- **Docusaurus v3 Classic Preset**: Site configuration in `docusaurus.config.js`. Docs in `docs/`, blog in `blog/`, custom React UI in `src/components/`, static assets in `static/`. +- **Docs & Blog Structure**: Docs are grouped by subfolders, each with optional `_category_.json` for sidebar organization. Blog posts use Markdown/MDX with metadata in YAML frontmatter and centralized author/tag files. +- **Sidebar Management**: `sidebars.js` controls sidebar structure. Update this when adding, moving, or regrouping docs. +- **Custom UI**: Reusable React components (e.g., `HomepageFeatures`, `TechStack`, `Portfolio`) live in `src/components/`. Global styles in `src/css/custom.css`; component styles in `src/components/*/styles.module.css`. + +### Developer Workflows +- **Install dependencies**: `yarn` (Node >= 20 required) +- **Start dev server**: `yarn start` (hot reload, port 3000) +- **Build production**: `yarn build` +- **Preview build**: `yarn serve` +- **Deploy to GitHub Pages**: `USE_SSH=true; yarn deploy` or `GIT_USER=; yarn deploy` +- **No automated tests**: Validate changes by running `yarn build && yarn serve` and inspecting `build/` output. + +### Project-Specific Conventions +- **Docs Grouping**: Use `_category_.json` in each `docs/` subfolder for sidebar grouping. Always update `sidebars.js` if moving docs. +- **Images**: Place global images in `static/img/`. For doc-specific images, use an `img/` folder next to the doc and reference with `./img/foo.png`. +- **MDX Usage**: Embed React components in docs/blogs via MDX. See examples in `docs/` and `blog/`. +- **Blog Metadata**: Blog posts require YAML frontmatter (`title`, `tags`, `authors`). Add new authors to `blog/authors.yml`. + +### Integration Points & External Dependencies +- **Docusaurus Packages**: See `package.json` for dependencies. Avoid adding large runtime dependencies unless justified. +- **Deployment**: Default is GitHub Pages. Ensure `organizationName` and `projectName` in `docusaurus.config.js` match the repo. +- **CI/CD**: No CI present. If adding, use Node >= 20 and include `yarn install && yarn build`. + +### Examples of Common Changes +- **Add a Doc**: Create `docs/
/new-doc.md` or `.mdx`. Update `sidebars.js` for sidebar changes. +- **Add a Blog Post**: Create `blog/YYYY-MM-DD-title.md` with YAML frontmatter. Update `blog/authors.yml` for new authors. +- **Edit Homepage Features**: Change `src/components/HomepageFeatures/index.js` and `styles.module.css`. Use `yarn start` for hot reload. + +### Watch-Outs & Gotchas +- **Node Environment**: Docusaurus config runs in Node.js. Avoid browser-only code (`window`, `document`). +- **Version Compatibility**: Uses Docusaurus v3 with `future.v4: true`. Test thoroughly before upgrading. +- **Sidebar/Category Sync**: Always sync changes between `_category_.json` and `sidebars.js`. + +### Contribution Guidelines - Make small, testable changes per PR (e.g., add a doc, update a component). -- Include screenshots for visual changes and verify the `build/` output. -- Update `sidebars.js` or `_category_.json` if moving docs between folders. - -## Contact / Maintainer Questions +- For visual changes, verify output in `build/` and include screenshots if possible. +- Update `sidebars.js` or `_category_.json` when moving docs. -- Confirm `organizationName` and `projectName` in `docusaurus.config.js` before changing deploy settings. -- For CI configuration or GitHub Actions templates, specify the Node version and preferred publish flow. +--- +If any section is unclear or missing, please provide feedback so this guide can be improved for future AI agents. From a4678e3b1481560c43295eea44bca9fd754f0852 Mon Sep 17 00:00:00 2001 From: marcelo-m7 Date: Sat, 8 Nov 2025 16:55:25 +0000 Subject: [PATCH 3/3] refactor: update documentation to English and improve clarity across various sections --- docs/intro.md | 20 ++++++------ docs/technologies/ci-cd/index.md | Bin 2059 -> 2074 bytes docs/technologies/convex/index.md | Bin 1069 -> 1084 bytes docs/technologies/coolify/index.md | Bin 1065 -> 1047 bytes docs/technologies/docker-compose/index.md | Bin 1339 -> 1372 bytes docs/technologies/flutter/index.md | Bin 396 -> 387 bytes docs/technologies/github-actions/index.md | Bin 1475 -> 1480 bytes docusaurus.config.js | 38 +++++++++++----------- sidebars.js | 6 ++-- 9 files changed, 32 insertions(+), 32 deletions(-) diff --git a/docs/intro.md b/docs/intro.md index 2d2f3da..8910f74 100644 --- a/docs/intro.md +++ b/docs/intro.md @@ -2,17 +2,17 @@ sidebar_position: 1 --- -# Bem-vindo à Documentação da Mona +# Welcome to MonaDocs -Esta é a central de documentação da **Monynha Softwares**, contendo guias, padrões e informações sobre nossos projetos, tecnologias e processos. +This is the central documentation hub for **Monynha Softwares**, containing guides, standards, and information about our projects, technologies, and processes. -## O que você encontrará aqui +## What you'll find here -- **Projetos**: Documentação detalhada de cada projeto desenvolvido pela Mona. -- **Tecnologias**: Guias sobre as tecnologias que utilizamos. -- **Padrões Internos**: Normas de código, arquitetura e melhores práticas. -- **Guias e Boas Práticas**: Tutoriais e recomendações para desenvolvimento. -- **Documentação para Contribuidores**: Como contribuir com nossos projetos. -- **Outros Temas**: Tópicos como UX, acessibilidade e dados. +- **Projects**: Detailed documentation for each project developed by Mona. +- **Technologies**: Guides about the technologies we use. +- **Internal Standards**: Code norms, architecture, and best practices. +- **Guides and Best Practices**: Tutorials and recommendations for development. +- **Contributor Documentation**: How to contribute to our projects. +- **Other Topics**: Topics like UX, accessibility, and data. -Explore as seções no menu lateral para mais informações. +Explore the sections in the sidebar for more information. diff --git a/docs/technologies/ci-cd/index.md b/docs/technologies/ci-cd/index.md index 915465ae5f394e387832ea5c295f1e3affcdd8f9..ff42f90a0e14846b20076013428682ece1e62c66 100644 GIT binary patch literal 2074 zcmb_dO^X{x5Y1Vj|4<;X*TN&kAtw<-?A_Q|LclCeaxli*nyHaG+tWSn4=KvOF**2@ zQ+|T}SYCC{takSh5{M8;-CbSvUe&AW8J%A)&o8Ev>0~ye3l6o{ebmm%&bhNu+vHN9 zOB;FPm7FZ^Y+rD1+@WI|=`1^XLOPJ5hIedSpAUMk>Zog`xK)uvG;7WY*TP;+$+zx zW%Q1{=CBy({<1yLo+$+cjEf!Qij-j=d+VnDnx3To3*NMsC6EUP|*I8EkjjJ1aT>;jFPYxLkyf<$|m#X-tHc>EUcx0!V%1Qv7!Jbukx{!sRO2 zTyoS{ZpsI7R%H7w?+ZH`q+AWjAMjXoAA+1f=ypXLG)P)6Jh$}xIX%X2SZ-N0VJTU7 zT%!CJCI#kDQPk{K00ry-cZNR4jDS|9c1@mg_n>DPV2lL607dR55mJ z{2(whW6{9>K=Xw6L1AVCJ0UELQ8>s`xZ)Lh2|?gxD6d8y8x{S)+*3b{4vcykoM+$A zvoEQ`3x(?ChW!bhT`LG>n58}2hHZ_JFKvTqYPdW}XhLJy22rP$Fyu!tlVVXWSnn%$0ix+nc1MgBL!2NQ!& zA-`b%SYCC{?5<1#hAacibiJv1RrRX+h)&Pvr)O1lbVO$yYOl8+w;xf z6*+)i%^^4e>k=tbkoS7~SEJYN8AT3wNZjp$!mfIQFo6HfVMa^#osLY1<9V$DwVn|U zKIO~W*;a2KZdnI$9b6mll;>Gaed&B=mV)YBsH!Q75xFizde1dD%2%tj9(@@dffS%H zI>@PUC0fwnjNrgra+7vRvG*=er)*MM9K2?3R;s=sRIS(ex>sIGH`I+A=UH$UY&Ono zMOJ~UGP+S<1pH8?oXBfp)4G)|O@VbR5^4?w zE_KfaaEjZ{y{;j{Bb+{;(Shs^)F^#=m9%L}^|R=pqkToD^y42~?@K?(Xs^E}xA3Li zJ{TQxhxe5|1`~|H`Wd9NVjq)NCkXf}l4*GcyPZh6`sQ#nN?=o_EHGo^nNze}|Bw-8<)RTI24j z>iYWnUUjCjP|9NH{aE^{a&}P>^(k!RpJ;{T>J5hlT|u?l(%Wn{=3O4I5dRZa{pMCd ztWx)a^2vrNB2Zc-8`IP%vE?|>P@mBfbV?~mNL7S72Z8#=rTD|`cNr{*LjN+^>^}_W zM2N8<+jsf6!g0~-bSQEmVlj2_zl*Nh1+8`5q}9xGOD|r~Q~ZbdhE)^hlK0ab;Oi48 z^oF)!^Nl^0^yHUm9zk4K1<;|is1QA%oEx1>@QC%}gfg$M;7?DUj4ARhCh(mw%$Z8F z|8IJGs*fA-uNgvtS)Q*P_SAS?Hzo8D-5>~Iw;xCxl zT0tA*&g|JX+fTOEN;c*>q|dSpu~3E!q{~Rd#=(xQ(rOGZlXY<%YFs7KidLD80tO2$ z6&K@0mCcWa>=HZ1hjMRRy-8TnaFAE(+v81)Q1yJ?xH`-RfuZGdw)0WjhLyL|Vw;YK z$u{gE8QWkld|{N-ua?6lo9TQJtWzGFt95sV{Y;|Cdu=$(Wg(Yq{a}yIHnB4&{{X9= B%isV2 diff --git a/docs/technologies/convex/index.md b/docs/technologies/convex/index.md index 0105eeaa5fbd114441a1e9001183c2170c3cb7c7..ad323daacd0a1733ed573029af6dc5ca55ecc6ec 100644 GIT binary patch literal 1084 zcmZuvT~FLF5ac;h{=jZj4uvE&Ac(%#N{Tqv!>Fi@C0&u~5NbgJ{GE}lvqt?+O$#_D=$#!@ zjlA1{GK5vBQ{U$RH4dn4-!XbI zDgV;m!H5t%f};3V!D%4dF(3I~j<7)*5e-PKcuv|LZ9x~Y>$HAvPm*l|K_`sZMt78H zobcp=q~I`uE_fNcd9mdUdTjWTR#6`g+8nh$?8je2iKARE2O4>LG7Y^vttPeHl9zUG^>Wnub`g{30M zDOp^6z`Yfo?c_qEwt?^Y7k(oKk+WA8s!RHJQ#M&i41$AumTx;a%!8LHUWc##=}(@m z@>QNe@~tAKEO?5ii6oqW!ExHRho7@G61`ub85XO{i_h=A{`|E5aFhl#!En5-fz!U9 zAHl9HfOE~qG%%0f0Iyfcf=2;){mCv1xPOzo0Cvk`_-2EPA%)}R{e)gVg{Ston(L3A z!WumznPk*d!S~CiQBnyFXI6%o@Z|E3c}vv$m&;{srC($M3(hCsm_d0Fobe4eR=9ev N{o&~;=AbMN{s7F^XvzQp literal 1069 zcmZuw%T60X5WMeKwD84_V*8$iNXT$NiUI;9iiD!jp6!K!-I>WemI%uqgE&O_fP8^} zEHyiJ0w}lHnd+{t>e>-4tm)-PRgFe;C_#C>`MG(tRaNe3^NUi)iLN(Vm zkaQHKb2h`<86CAkpfv)HJjap)kUOw8QLa4K{F*pLF|n|rpU}bSaUjQ@0S{t&+xEHx z1f4ezPS*qHvjLmbw$l(HZ#LL*YW<)q1@3I9swthnm>Q(E+dO32e?x)8!-Q7jAQ)t@ zsJ0&UF!;Zd1gO3eFGgwhq)p>lvV}2u&a}x{k6tDlXp5*bVHMHcrs&}*DmuBd{x$%A z6co3-)UAf6lC9ZIS#)`OBN1NbrKJeiJ$G5&_y8&zZLqm1xo0R?uuaNj=&`V!B^cxL z*NBd>aZqlfb9s4*JzZDEbr6$Z+8l};Gdz_F#H-O)&{y`q+&l!hSY^NsBP9r;id)x zNeDA+Z?-u3`1$C|w@+suCMa)`QBhk%2hNQrw5kZn#oi2!aU^;Np%DIe@S@UzF~EWU diff --git a/docs/technologies/coolify/index.md b/docs/technologies/coolify/index.md index 547a991c0855d4195df10c12fce2be9d7ac222be..800a67b27c254829ea497e25b5131c81f420ad8d 100644 GIT binary patch literal 1047 zcmZWoO^e$w5bZgT|1glt7B&w3IPI-%+Ge42Lzit2rI4{aj7`3v2xA*NN1Si ziII?LJUia@5CzRH=E_?y$%@_6AmSy1=aF;eT}OT%RXpW~PMLZYTl<7zMS*u|@sl*? zj_lTfAIYeq!^+M{UR|cfHN)QG$tSOm5Gy`pbnP7jGo4l^cWQUjs6m#aViWZmZBja`R4Ueq(R2OQN|Q>Ju^r^gQa&rG I-LLff2jC}UEdT%j literal 1065 zcmZXT&2H2%6ovPBiYv{gBXu(3XVo3*07XJDqJm9@RL8lQaqIX7|4h}2m#MlytSdHb z^I{x3r7cCu!j`YE@A=Njj1EPt=`O2kHlq~>?alaOypgK9JD~9=rC!lsRaBjLEL+Am zSh?)kMG9=Y#a2S(mcAvXfqicxQ>U)j-xcO7YOqEtH2=kcF1XpJMma5^v{Nk>j9z|+ z_w%}+Hm!J+4}QEIypd4TYm2fph>wc;@wbfzlLfNIZIars%WXQZdcF{U9`;E(_N>{p zQe+qx*>_4~p5AQ6>m6GflvlJtnbQUrU6eeNacILK`V^B_bpf;%Uo@tmdI?pv06rJJ zV5TThSqjp4w0?3Kb*lo5REpB8Xs#gmDHK#47hzzSCwinVM5WIIMb=L2c)J0}fbw_u zV!#t`#$=+|!K?oSq4<@Ba)-B3AOpKakmNH5p(FNko|a!2dpimBa>fxpWJgmp78Cbb z@80_HN%pvhjvNNs8TB_!^U~x{dO#1#=iLm`LWa!=cpR@mz#6_|{BjH~Xqg`Dr_W7- zvgL{!qufDNot~aHDr_sAyro4Kj^EQZ#vvRmm%4SeMxd=~LTzN3*9iA=>TT<=rSFIx zE~Cjb)txcTcpZ#J?4Q-yQ`Sgu;6$DW2_}xWNFTj5v3g$4JF`jI=s-J#KL#-}CCI98 z3`q&x7*M8l*hcSuI99q#~4);!=;3zfdQ&fq+d???TxJ?c4^#xl- I_&{*}2a5WJY5)KL diff --git a/docs/technologies/docker-compose/index.md b/docs/technologies/docker-compose/index.md index 22df0bd0f9f283b71c810129d6ad6e05f2f25775..d6432210cb3898f8a0614e266624947bcace189c 100644 GIT binary patch literal 1372 zcmah}QE%EX5Z*Hq|KU^~+De0T>dO>q4_&FcNn7d4)M}b0Y8(e{ICkcxx(6{xqJ5B`WGN zdIDwE=&XqdAmu|Harep*7llE_yRNWkN+(!DkUqGm+LX8mtt37?HR{&c-%5G{zZ8Bi zgOkIp7j0~t_fKw?5;*OMKiMXBglp0+4B(?6lu#tQaA%WUMw^OFz}1eR$H&KwsC2)# zZj;I3_7O=q_k)9J(HZp?9lh&@`gL5Fg-yt6`hk!Ne+GL7?WyZlFIaU)iCH+H+- zMy0B6JH#_wB@eas?s_s8v}CWq)C(6K*G^Esx8F&KK75ApEX{>nEu0O86F9)akXKu{ ztzRcCY?CgK0oM@V&uA0$r5RDDXKldh8l*$1lmcQOa<*HAx%#I>gcL%zX2G^Vk85OnHSC4o%$}heV*OE{O=E zuR|XUltfG;<=Js)m&D4rU9d<2yRbAm)aZtQHN}Cj*Fh}}ygzvJnwV5*u_;w|pK8G{ z{1c5d4xD04mqoP`W8pd=1Se|ak|c#O;h^)D$rA&KPKYkjY$b+p{fvRa1AL^ zH47`4TJUt=)3@d$dLkAzcuMt2)U0A>vSA^0t1cY&y^vZmoG_rdIRG9Dexj!w>ANSYjNTDC^-$GQ0FnH4#u zjW!PCL*5vPv)af&laP=}&U=4ViwX;%ZSa*P%Fp)y#$Yl&eS17TI-N}pPEX&Brz46I z&fOR*|4d_rIg`SRB3}xdYcNF{quXv_ZrDa}p8ZZyQS1eJS=6Yt1A zMP3e?-}qM0lfg`%I@6Y~PZF&?y&?U6ju(ugKkQt3-?}2tNv_L! t%^8&^f1K2ONLz7!927rSB)|JwDg)E*zE#rvKe|HiRZ}^7+dRsA_ya73&b|Nu diff --git a/docs/technologies/flutter/index.md b/docs/technologies/flutter/index.md index 12606cbdf998104f57a6886a56e2e2d2e0d9c0b4..611c5f700a9cf0088a2ae45018e71de3d8d02e03 100644 GIT binary patch literal 387 zcmY+APiw<448?a2@aq4Y`O93SjJLT`t7HrxfBeB_oSzv z)WBn$M6lFVT{R8tkZlQB0;O45O$ZE6MEi)>44*IHiy84q~$&^P->bLN^pg>5vnl~0_?U@9M78$poc*Anpwp`%7&@WnHkip2s z#CsC7r2Y!^flO1e$Y-GMH}8WDCc=*FG=nUA|J)2BneV#JpD(>t)XtIR+q$~a_YZL{ BemejF literal 396 zcmY+AF;4?A42Adm6_&by1ntg-{mDUKh3~ z@A>)jo54-!RVg>kYz9jzF7x;~9;9hb0*qhKM`$xf+DqPnCwN?e7q}JK27-hc!NxEH zroawu{)Y;5s61c+CoyqAZ_lGO%7z17z@9chmR5Eu39yRFxyJVqVf^hZ3N~1(2i*AW zc`NfH=2|km_2w%Wr8LcD1*dM1FmR+!#c-sQ%M?&s$Yx15bZfq{=-N)v`BG+5T{58+5~7N3RRKdP*ue7&Su^0+KWFD!mnq>-c6cb zxb1qLpWn=znGt-};X1D1QUz^|9}b3t(FhjkmD4RB@yRI$vXn*ifPCspzpF{l-r^**~j2>=2?y(1Fhce5D7s^xMg!giiE1Y^~S9I*pXO zfR9^}Bv#UM9=$NQXrr&jaCbijhc!~vzhd+k>DCCStl#^94cHP|hl0gZ)_p|7>SrcMmY<#I2Z zdN?q$!5Q@ivsg154gk1z=>uTpq)`?689YEEwP9huYY4Z*K6R9Gz-l8dKQX3n?hwWPy&JYIWWWHmFEqt{F zPM*l39E2APo49)(U_K4OH}W{+oZ{^s@hkr6;iQbNaj=?n$>P_N|1_&~G7 z^MIy6qf*oMZ&CU);G5L!87D;P>|ZpZwrW%AI(eJnJ>`8gX~>=>cI3(Bd#U1zN3%Z! zIKq<`!vXa|-$QfTG}Oz7N#L1Tc7M-{zNBK$sWQ+TaRNN4EkipmAO%jKkrst4gmgid z^bUE!_{;7Wa`@y%-Yue)YxEs_k=6~5L$~+tIGA&Sd(1O-~y^488BKu*3n7vPo6-6shV*s3-?oL{;^GP&1izU|@Ek#nm=az1Qgf|$_EyylR zi!RcDGijTQYY1k^*k%9`L&O0CJ4;JIpcK6d5S7O{|86rkDhzWEC*(njr=VKmwrV&k z^m1F^n8!karWQPQ6ii&*dqbh;&G2saNzTa`b8Sm#K2Zho7iZ;l$d-WFm{JJb!t*LMcTZItY}! zM#fLbMNd{lg9ZA)cLc(1BWUS<9h@bI#U~ z3ov8V^d*KdoI$IMlZ#%!dB#}#-6MAq;{UPL70rS`^28LZPcGD44ALyQm};I`&XY@W z^Ie8Z{hC{o>is>9n2WyV5qrCMRb{k53jHq_QwN`@!QoZt&)`XT5KQeDBMGE{d~R5v zLaRK>c`Y}{wj0Cl%NM&FD1cVXf!{8bce_tH9Pt1tYsC%7)8@3nEfwy03=+mBDzLhq zd%8teThiBaWASOe)8w+jo=cJid!oU6@#Kc=wqRCXuDcA$dXU&-d=D~w(`N*pvb2+4 zZysdOtNX@W&_nbiJq7>x5+3ADydG3jD<93AYq9(S|C-;5VfcXe1)J(&`m$8&PF-N= zBM!=*$v*7&--#S&FPySreJDHSjJ=d(X{lo2&vT=Vvgdo3G4gzkMh$zd_r{Qg7@-^W jBFMTpJ68T0BQH~(4c$w&4KJ?Bk?j`xCN4XCz0UIwm}c%t diff --git a/docusaurus.config.js b/docusaurus.config.js index cdb40e4..a30e1b6 100644 --- a/docusaurus.config.js +++ b/docusaurus.config.js @@ -11,7 +11,7 @@ import {themes as prismThemes} from 'prism-react-renderer'; /** @type {import('@docusaurus/types').Config} */ const config = { title: 'MonaDocs', - tagline: 'Documentação Central da Monynha Softwares', + tagline: 'Central Documentation Hub for Monynha Softwares', // Use an SVG favicon for crisp rendering on modern browsers // If you need .ico for legacy support, add `static/img/favicon.ico` and update this line. favicon: 'img/favicon.svg', @@ -94,25 +94,25 @@ const config = { // Explicit dropdown exposing main documentation areas so the mobile menu // shows all relevant links (projects, technologies, guidelines, etc.). { - label: 'Documentação', + label: 'Documentation', position: 'left', items: [ - { to: '/docs/intro', label: 'Introdução' }, - { to: '/docs/technologies/frontend-stack', label: 'Tecnologias' }, + { to: '/docs/intro', label: 'Introduction' }, + { to: '/docs/technologies/frontend-stack', label: 'Technologies' }, { to: '/docs/guidelines/ux-guidelines', label: 'Guidelines' }, - { to: '/docs/identity/brand-guidelines', label: 'Identidade' }, - { to: '/docs/contribution/contributing', label: 'Contribuição' }, - { to: '/docs/architecture/backend-architecture', label: 'Arquitetura' }, + { to: '/docs/identity/brand-guidelines', label: 'Identity' }, + { to: '/docs/contribution/contributing', label: 'Contribution' }, + { to: '/docs/architecture/backend-architecture', label: 'Architecture' }, ], }, { to: '/blog', label: 'Blog', position: 'left' }, { - label: 'Empresa', + label: 'Company', position: 'right', items: [ { label: 'Monynha.com', href: 'https://monynha.com' }, - { label: 'Projetos', href: 'https://monynha.com/projetos' }, - { label: 'Portfólio', href: 'https://marcelo.monynha.com/portifolio' }, + { label: 'Projects', href: 'https://monynha.com/projetos' }, + { label: 'Portfolio', href: 'https://marcelo.monynha.com/portifolio' }, ], }, { @@ -126,41 +126,41 @@ const config = { style: 'dark', links: [ { - title: 'Documentação', + title: 'Documentation', items: [ { - label: 'Introdução', + label: 'Introduction', to: '/docs/intro', }, { - label: 'Projetos', + label: 'Projects', to: '/docs/projects/boteco-pro', }, { - label: 'Tecnologias', + label: 'Technologies', to: '/docs/technologies/typescript', }, ], }, { - title: 'Empresa', + title: 'Company', items: [ { label: 'Monynha.com', href: 'https://monynha.com', }, { - label: 'Projetos', + label: 'Projects', href: 'https://monynha.com/projetos', }, { - label: 'Portfólio', + label: 'Portfolio', href: 'https://marcelo.monynha.com/portifolio', }, ], }, { - title: 'Comunidade', + title: 'Community', items: [ { label: 'Blog', @@ -177,7 +177,7 @@ const config = { ], }, ], - copyright: `Copyright © ${new Date().getFullYear()} Monynha Softwares. Construído com Docusaurus.`, + copyright: `Copyright © ${new Date().getFullYear()} Monynha Softwares. Built with Docusaurus.`, }, prism: { theme: prismThemes.github, diff --git a/sidebars.js b/sidebars.js index 6167ff3..0db5c50 100644 --- a/sidebars.js +++ b/sidebars.js @@ -20,13 +20,13 @@ const sidebars = { 'intro', { type: 'category', - label: 'Projetos', + label: 'Projects', link: { type: 'generated-index', - description: 'Documentação dos projetos Monynha (visões gerais, stacks e guias).', + description: 'Documentation for Monynha Softwares projects: overviews, tech stacks, and guides.', }, items: [ - 'projects/boteco-pro/index', + 'projects/boteco-pro', 'projects/artleo-creative-spaces/index', 'projects/boteco-pt/index', 'projects/facodi/index',