update roadmap docs

Signed-off-by: Emma Indal <emma.indahl@gmail.com>
This commit is contained in:
Emma Indal
2022-03-17 10:14:36 +01:00
parent b1fc1c3c44
commit d50fbeddc1
2 changed files with 13 additions and 31 deletions
+13 -19
View File
@@ -74,32 +74,26 @@ providers are used.
storage solutions, source control systems).
- [Instructions for upgrading from Alpha to Beta](how-to-guides.md#how-to-migrate-from-techdocs-alpha-to-beta)
**v1**
TechDocs packages
- '@backstage/plugin-techdocs'
- '@backstage/plugin-techdocs-backend'
- '@backstage/plugin-techdocs-node'
- '@techdocs/cli'
promoted to v1.0! To understand how this change affects the package, please check out our [versioning policy](https://backstage.io/docs/overview/versioning-policy).
### **Future work 🔮**
**General Availability (GA) release** -
[Milestone](https://github.com/backstage/backstage/milestone/30)
- Bugs are rare, TechDocs APIs are stable and scales easily in large
organizations.
- Better integration with
[Scaffolder V2](https://github.com/backstage/backstage/issues/2771) (e.g. easy
to choose and plug documentation template with Software Templates).
- Static site generator agnostic
- Possible to configure several aspects about TechDocs (e.g. URL, homepage,
theme).
**Implement Feedback loop** -
[Milestone](https://github.com/backstage/backstage/milestone/31)
- A feedback loop between documentation reader and writer using TechDocs
- The `+` in `docs-like-code+` experience
**TechDocs widget framework**
Platformize TechDocs with a widget framework so that it is easy for TechDocs
contributors to add pieces of functionality and for users to choose which
functionalities they want to adopt. As a pre-requisite, the re-architecture of
TechDocs frontend [RFC](https://github.com/backstage/backstage/issues/3998)
needs to be addressed.
- [TechDocs Addon Framework](https://github.com/backstage/backstage/issues/9636)
## Tech stack
-12
View File
@@ -131,15 +131,3 @@ layer for users to determine whether they have the permission to view a
particular docs site. There are a handful of features which are extremely hard
to develop without a tightly integrated backend in place. Hence, support for
`techdocs` without `techdocs-backend` is limited and challenging to develop.
# Future work
_Ideas here are far fetched and not in the project's milestone for near future
(~6 months)._
We currently depend on MkDocs to parse doc sites written in Markdown. And we
store the generated static assets and re-use it later to render in Backstage. A
better (futuristic) approach will be to directly parse whatever type of source
files you have in your docs repository and directly render in Backstage in
real-time. You can read more in this
[RFC - Simplifying TechDocs Frontend Architecture](https://github.com/backstage/backstage/issues/3998).