doctrine / doctrine/static-website-generator

Future of this project

Open
#18 5 comments 0 reactions 0 assignees View on GitHub
Dominant language
PHP
Stars
5
Forks
3
PR merge metrics
No merged PRs in 30d

Description

This project is used by the doctrine-website and is using the RST-parser. With the introduction of phpDocumentor guides in the doctrine website the rst based pages as now rendered by a special renderer in the website project.

To completely remove the rst parser from the doctrine website we would need to replace the rendering here as well. I do see 2 options:

1. abandon this project and move it into the doctrine website so we can remove the RST parser from the dependencies
2. replace the RST parser in this project by guides

Please let me know which direction to take, and I will make it happen.

Contributor guide

Open the contributing guide

Research direction

Start by reviewing how the doctrine-website uses this static website generator and where the RST parser dependency is involved. The maintainers must first choose between moving the project into doctrine-website or replacing its RST parser with guides; done means one direction is agreed and the resulting rendering path no longer requires the RST parser.

Written by the indexing model from the issue text.

Assessment

Tech stack
php
Domain
tooling, web-dev
Issue type
Refactor
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
20/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.