Faycal Alami Hassani
I help SaaS teams write docs, not support tickets.
New to Contra
Faycal is building their profile!
I restructured a documentation portal from one flat blog folder into three independently localizable sections: each with its own RSS feed, sidebar, and translation directory. No CMS, no manual slug management: the folder structure sets the URL. Built to scale to hundreds of articles per section without touching the architecture again.
0
23
An OpenAPI spec that lints clean but still fails developers. I found several documentation gaps, including vague error responses, undocumented API behavior, and missing examples. I rewrote them from a developer's-first-encounter perspective. Full before/after breakdown linked.
0
20
I built and maintain a structured technical reference spanning four domains on Sphinx: API fundamentals, version control, networking, and documentation tooling. No CMS, one Git-based source, each section independently navigable but consistently structured. A working example of what docs-as-code looks like at reference-site scale.
0
33
Sui isn't just another blockchain to document. It introduces a new language and an object-centric model that requires developers to unlearn old assumptions. I reviewed whether the docs actually teach that shift or just assume it. Among the gaps I found: a wallet defaulting to mainnet with no warning, and a CLI command that silently triggers setup. Full review linked.
1
65