I sure have learned a lot from this initial effort to contribute to phpBB and the comments/reviews that I've been given on the pull request have been very educational. Thanks to hanakin and vinny for sharing their knowledge, it has been much appreciated.
However, as a newcomer, I've struggled to understand some of the more nuanced comments related to which file should be used for what purpose/content. Other than Rhea coding guidelines document
and the comments in specific files, it seems to this newcomer that there are gaps in the documentation that would help guide a newcomer to understand all the conventions. Am I missing something in the basic tool chest that a newcomer to phpBB coding should read and follow?
For example, there are 17 CSS files in
and while most of the filenames give clues to their function, making what seems like a simple coding change has now involved four of CSS files, which wasn't immediately obvious from any of the documentation and code that I've read so far. I got some ideas from How to create a Style [Basics]
Finding the right class to edit can be really hard. Especially with phpBB, because all classes have multiple subclasses.
When you need a class, you first need to look what it is you want to change. Is it a color from a link or a header text, or something else?
I thought it would be helpful to share this experience in the hope that it might generate further documentation or reference material that would be helpful to newcomers who want to contribute to phpBB.