mvpfy-document

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Consolidar o MVP.md

整合MVP.md文件

Use
assets/MVP.template.md
como fonte estrutural. O documento final deve ser um único arquivo Markdown, compreensível sem o histórico da conversa, com metadados, resumo do MVP, problema, público, personas, escopo, SaaS, mercado, preço, custos, tecnologia, marketing, métricas, plano de execução e pendências.
Execute
scripts/render-company.mjs --project <diretório>
para criar ou atualizar o arquivo. O script localiza seções pelos IDs HTML
mvpfy:section:<id>
, preserva conteúdo existente e usa “Pendente” quando faltarem dados.
Execute o mesmo script com
--check
antes de uma gravação. Valide depois com
scripts/validate-company.mjs --project <diretório>
. O estado só pode ser
ready
quando os campos mínimos do MVP SaaS estiverem preenchidos; caso contrário, use
preliminary
e liste as lacunas.
assets/MVP.template.md
为结构模板。最终文档需为单个Markdown文件,无需依赖对话历史即可理解,包含元数据、MVP概述、问题、受众、用户画像、范围、SaaS、市场、定价、成本、技术、营销、指标、执行计划和待办事项。
执行
scripts/render-company.mjs --project <目录>
来创建或更新文件。该脚本通过HTML ID
mvpfy:section:<id>
定位章节,保留现有内容,数据缺失时使用“待办”标识。
在写入前,需使用
--check
参数执行同一脚本。之后用
scripts/validate-company.mjs --project <目录>
进行验证。只有当SaaS MVP的必填字段全部填写完成时,状态才可设为
ready
;否则设为
preliminary
并列出缺失项。

Gate editorial e de publicação

编辑与发布审核

Antes de gerar um ebook, confirme que
docs/user/reading-order.txt
contém somente páginas destinadas à pessoa usuária. A referência técnica e a especificação continuam disponíveis online, mas não entram no guia do usuário. Compare a estrutura com um projeto de referência do Hub e mantenha a identidade visual sem copiar sua prosa.
Leia o conjunto de páginas como uma publicação inteira. Reescreva trechos que pareçam catálogo, lista de recursos ou anotação de agente. Cada seção pública precisa explicar a situação, a ação, o efeito e o limite da orientação. Listas e tabelas devem organizar informação paralela, nunca substituir a explicação.
Depois da leitura editorial, gere PDF e EPUB, leia o resultado e rode os validadores do submódulo e do Hub. Um build correto comprova o arquivo gerado, mas não comprova a qualidade do texto.
Use o mesmo SemVer do framework no PDF, no EPUB e no manifesto.
VERSION
é a fonte canônica e
ebooks/VERSION
é apenas um espelho conferido pelo build. Se os valores divergirem, corrija a versão antes de gerar ou publicar os formatos.
Leia document-rules.md para a ordem canônica.
生成电子书前,确认
docs/user/reading-order.txt
仅包含面向用户的页面。技术参考和规格说明仍在线上提供,但不纳入用户指南。将结构与Hub的参考项目对比,保持视觉一致性但不复制其文案。
将所有页面作为完整出版物通读。重写那些看起来像产品目录、功能列表或代理注释的段落。每个公开章节需解释背景、操作、效果及指南的局限性。列表和表格应用于整理平行信息,绝不能替代文字说明。
编辑审核完成后,生成PDF和EPUB格式文件,通读结果并运行子模块和Hub的验证器。正确构建仅能证明文件生成无误,但无法保证文本质量。
在PDF、EPUB和宣言中使用与框架相同的SemVer版本。
VERSION
为权威版本源,
ebooks/VERSION
仅为构建过程中同步的镜像版本。若两者数值不一致,需在生成或发布格式文件前修正版本。
阅读document-rules.md获取标准顺序。