To makes things simple to explain lets take the following post as an example as it uses a little bit of all the basics
https://area51.phpbb.com/phpBB/viewtopi ... 21#p295921
The BBCODE
Code: Select all
Creating a new theme for phpBB is a daunting task especially given the small number of individuals on the team and the fact that most of us have day jobs.
In order to help drive this thing and generate community involvement both in discussions and development, I wanted to put together a sort of outline of what we need to help steer the individual topics as well as provide a sort of table of contents for reference and ultimately a checklist/progression chart.
Before we start let me preface how this is laid out for better understanding.
There are four main stages or areas of focus each with their own sub task. They are listed in order of requirement/workload.
[list=1]
[*] StyleGuide ( GUI for editing, maintaining & documenting themes )
[*] Themes Code
[*] Themes Design
[*] Any Core Improvements/fixes
[/list]
Each task/subtask should have its own dedicated discussion thread to avoid confusion
sub task will be defined and added/linked appropriately as we progress.
This should also allow for community involvement with the actual development in an easier to follow manner
[b][u]KEY[/u][/b]
β Have not started working on it or still in discussion
π§ Working on it, still in progress
β Needs reviewed
β
Merged or completed
[status] [disscussion link] [pull-request]
EXP: π§ [url=http://area51.phpbb.com/phpBB/viewtopic.php?f=131&t=50381]How to handle icons[/url] ([url=http://area51.phpbb.com/phpBB/viewtopic.php?f=131&t=50381]#ticket-18273[/url])
[b][u][color=#FF0000]PLEASE KEEP DISCUSSION IN THIS THREAD RELATED TO IMPROVING, CHANGING OR UPDATING THE LIST ONLY[/color][/u][/b]
[list=1]
[*] StyleGuide
[*] Theme Code
[list]
[*]β [url=http://area51.phpbb.com/phpBB/viewtopic.php?f=131&t=47746]1. What browsers should we support?[/url]
[*]π§ [url=http://area51.phpbb.com/phpBB/viewtopic.php?f=131&t=50326]2. Why is a framework so usefull?[/url] (https://github.com/hanakin/base-l)
[*]π§ [url=https://area51.phpbb.com/phpBB/viewtopic.php?f=131&t=50426]3. Lets talk grids[/url]
[/list]
[*] Design
[*] Core Changes
[/list]
Code: Select all
Creating a new theme for phpBB is a daunting task especially given the small number of individuals on the team and the fact that most of us have day jobs.<br>
<br> In order to help drive this thing and generate community involvement both in discussions and development, I wanted to put together a sort of outline of what we need to help steer the individual topics as well as provide a sort of table of contents
for reference and ultimately a checklist/progression chart.<br>
<br> Before we start let me preface how this is laid out for better understanding.<br>
<br> There are four main stages or areas of focus each with their own sub task. They are listed in order of requirement/workload.
<ol style="list-style-type: decimal">
<li> StyleGuide ( GUI for editing, maintaining & documenting themes )</li>
<li> Themes Code</li>
<li> Themes Design</li>
<li> Any Core Improvements/fixes</li>
</ol>
Each task/subtask should have its own dedicated discussion thread to avoid confusion<br>
<br> sub task will be defined and added/linked appropriately as we progress.<br>
<br> This should also allow for community involvement with the actual development in an easier to follow manner<br>
<br>
<span style="font-weight: bold"><span style="text-decoration: underline">KEY</span></span><br>
<img alt="β" class="emoji smilies" draggable="false" src="//cdn.jsdelivr.net/emojione/assets/svg/2753.svg"> Have not started working on it or still in discussion<br>
<br>
<img alt="π§" class="emoji smilies" draggable="false" src="//cdn.jsdelivr.net/emojione/assets/svg/1f6a7.svg"> Working on it, still in progress<br>
<br>
<img alt="β" class="emoji smilies" draggable="false" src="//cdn.jsdelivr.net/emojione/assets/svg/231b.svg"> Needs reviewed<br>
<br>
<img alt="β
" class="emoji smilies" draggable="false" src="//cdn.jsdelivr.net/emojione/assets/svg/2705.svg"> Merged or completed<br>
<br> [status] [disscussion link] [pull-request]<br>
<br> EXP: <img alt="π§" class="emoji smilies" draggable="false" src="//cdn.jsdelivr.net/emojione/assets/svg/1f6a7.svg"> <a href="http://area51.phpbb.com/phpBB/viewtopic.php?f=131&t=50381" class="postlink">How to handle icons</a> (<a href="http://area51.phpbb.com/phpBB/viewtopic.php?f=131&t=50381"
class="postlink">#ticket-18273</a>)<br>
<br>
<span style="font-weight: bold"><span style="text-decoration: underline"><span style="color: #FF0000">PLEASE KEEP DISCUSSION IN THIS THREAD RELATED TO IMPROVING, CHANGING OR UPDATING THE LIST ONLY</span></span>
</span><br>
<br>
<ol style="list-style-type: decimal">
<li> StyleGuide</li>
<li> Theme Code
<ul>
<li><img alt="β" class="emoji smilies" draggable="false" src="//cdn.jsdelivr.net/emojione/assets/svg/231b.svg"> <a href="http://area51.phpbb.com/phpBB/viewtopic.php?f=131&t=47746" class="postlink">1. What browsers should we support?</a></li>
<li><img alt="π§" class="emoji smilies" draggable="false" src="//cdn.jsdelivr.net/emojione/assets/svg/1f6a7.svg"> <a href="http://area51.phpbb.com/phpBB/viewtopic.php?f=131&t=50326" class="postlink">2. Why is a framework so usefull?</a> (<a href="https://github.com/hanakin/base-l"
class="postlink">https://github.com/hanakin/base-l</a>)</li>
<li><img alt="π§" class="emoji smilies" draggable="false" src="//cdn.jsdelivr.net/emojione/assets/svg/1f6a7.svg"> <a href="https://area51.phpbb.com/phpBB/viewtopic.php?f=131&t=50426" class="postlink">3. Lets talk grids</a></li>
</ul>
</li>
<li> Design</li>
<li> Core Changes</li>
</ol>
<span style="font-weight: bold">
instead of <strong class="post-copy-bold">
I am sure the same could be said for italics with the
<em>
The second big thing is the over use of
<br>
tags and the lack of <p>
to clarify I am not against using <br>
tags but they should only be used for extra indentation where as <p>
should be the default for a single line return.That means we should end up with something more like this
Code: Select all
<p>
Creating a new theme for phpBB is a daunting task especially given the small number of individuals on the team and the fact that most of us have day jobs.
</p>
<p>
In order to help drive this thing and generate community involvement both in discussions and development, I wanted to put together a sort of outline of what we need to help steer the individual topics as well as provide a sort of table of contents for reference and ultimately a checklist/progression chart.
</p>
<p>
Before we start let me preface how this is laid out for better understanding.
</p>
<p>
There are four main stages or areas of focus each with their own sub task. They are listed in order of requirement/workload.
</p>
<ol style="list-style-type: decimal">
<li> StyleGuide ( GUI for editing, maintaining & documenting themes )</li>
<li> Themes Code</li>
<li> Themes Design</li>
<li> Any Core Improvements/fixes</li>
</ol>
<p>
Each task/subtask should have its own dedicated discussion thread to avoid confusion
</p>
<p>
sub task will be defined and added/linked appropriately as we progress.
</p>
<p>
This should also allow for community involvement with the actual development in an easier to follow manner
</p>
<p>
<strong>
<span style="text-decoration: underline">KEY</span>
</strong>
</p>
<p>
<img alt="β" class="emoji smilies" draggable="false" src="//cdn.jsdelivr.net/emojione/assets/svg/2753.svg"> Have not started working on it or still in discussion
</p>
<p>
<img alt="π§" class="emoji smilies" draggable="false" src="//cdn.jsdelivr.net/emojione/assets/svg/1f6a7.svg"> Working on it, still in progress
</p>
<p>
<img alt="β" class="emoji smilies" draggable="false" src="//cdn.jsdelivr.net/emojione/assets/svg/231b.svg"> Needs reviewed
</p>
<p>
<img alt="β
" class="emoji smilies" draggable="false" src="//cdn.jsdelivr.net/emojione/assets/svg/2705.svg"> Merged or completed
</p>
<p>
[status] [disscussion link] [pull-request]
</p>
<p>
EXP: <img alt="π§" class="emoji smilies" draggable="false" src="//cdn.jsdelivr.net/emojione/assets/svg/1f6a7.svg"> <a href="http://area51.phpbb.com/phpBB/viewtopic.php?f=131&t=50381" class="postlink">How to handle icons</a> (<a href="http://area51.phpbb.com/phpBB/viewtopic.php?f=131&t=50381"
class="postlink">#ticket-18273</a>)
</p>
<p>
<strong>
<span style="text-decoration: underline">
<span style="color: #FF0000">PLEASE KEEP DISCUSSION IN THIS THREAD RELATED TO IMPROVING, CHANGING OR UPDATING THE LIST ONLY</span>
</span>
</strong>
</p>
<ol style="list-style-type: decimal">
<li> StyleGuide</li>
<li>
Theme Code
<ul>
<li>
<img alt="β" class="emoji smilies" draggable="false" src="//cdn.jsdelivr.net/emojione/assets/svg/231b.svg"> <a href="http://area51.phpbb.com/phpBB/viewtopic.php?f=131&t=47746" class="postlink">1. What browsers should we support?</a>
</li>
<li>
<img alt="π§" class="emoji smilies" draggable="false" src="//cdn.jsdelivr.net/emojione/assets/svg/1f6a7.svg"> <a href="http://area51.phpbb.com/phpBB/viewtopic.php?f=131&t=50326" class="postlink">2. Why is a framework so usefull?</a> (<a href="https://github.com/hanakin/base-l"
class="postlink">https://github.com/hanakin/base-l</a>)
</li>
<li>
<img alt="π§" class="emoji smilies" draggable="false" src="//cdn.jsdelivr.net/emojione/assets/svg/1f6a7.svg"> <a href="https://area51.phpbb.com/phpBB/viewtopic.php?f=131&t=50426" class="postlink">3. Lets talk grids</a>
</li>
</ul>
</li>
<li> Design</li>
<li> Core Changes</li>
</ol>
Now I may be missing something that is in the works or is planned, but these are kind of crucial to proper control of the content within a post.