Version-adaptive documentation: Difference between revisions

From GNU Radio
Jump to navigation Jump to search
m (correct bullets)
(add test results)
Line 5: Line 5:


<h3>Phase 1</h3>
<h3>Phase 1</h3>
<h4>Plan</h4>


* Emulate MediaWiki with a local nodeJS program to allow non-destructive testing.
* Emulate MediaWiki with a local nodeJS program to allow non-destructive testing.
* Create a test page with sections which can be hidden, based on 'data-*' attribute.
* Create a test page with sections which can be hidden, based on a 'data-vad' attribute.
* Create a form to enter Version info.
* Create a form to enter a Version selection.
* Store Version info in a user cookie.
* Store the Version selection in a user cookie.
* Before displaying the page, execute a script to show or hide sections relevant to the Version info.
* Before displaying the page, execute a script to show or hide sections relevant to the Version selection.
 
<h4>Test results</h4>
----
<p>All versions selected.</p>
[[File:Phase1_all.png|326px]]
----
<p>Version 3.9 selected.</p>
[[File:Phase1_3-9.png|329px]]

Revision as of 02:11, 27 November 2022

Concept

I am looking into the possibility of making certain pages of our Wiki be adaptive to the user's GNU Radio version (or desired version) so that sections which don't apply would be hidden. This would make cleaner page presentations and reduce the clutter of unrelated information.

Proof of Concept

Phase 1

Plan

  • Emulate MediaWiki with a local nodeJS program to allow non-destructive testing.
  • Create a test page with sections which can be hidden, based on a 'data-vad' attribute.
  • Create a form to enter a Version selection.
  • Store the Version selection in a user cookie.
  • Before displaying the page, execute a script to show or hide sections relevant to the Version selection.

Test results


All versions selected.

Phase1 all.png


Version 3.9 selected.

Phase1 3-9.png