Using emojis to highlight macros (or other things)

[telumire]

+1!

I also like to use emojis to visually structure my wikitext through HTML comments. For example:

\procedure table()
<!-- 🧮Logic -->
\function get.estimate() [subfilter<tasks>get[time-estimate]sum[]add<add-hours>]
\function get.spent() [subfilter<tasks>get[time-spent]sum[]]
\function time.estimate.field() [[time-estimate-$(Experience)$]substitute[]]
\function get.time.estimate.field() [{!!title}get<time.estimate.field>]

<!-- 🧱Markup -->
\procedure task() <$checkbox tag="done"> <$link/></$checkbox>
\procedure edit-table()
<$checkbox field="edit-table-data" checked="true" unchecked="false"> Estimate</$checkbox>
\end edit-table
\procedure table-template()
<<style>>
<table>
<caption>Estimated (depend on [[your experience|Profile]]): <$text text={{{ [get.estimate[]] }}} />h, Spent: <$text text={{{ [get.spent[]] }}} />h</caption>
  <thead><$slot $name="thead-inner"/></thead>
  <tbody><$slot $name="tbody-inner"/></tbody>
</table>
\end table-template
\procedure table-edited() 
<$transclude $variable="table-template">
<$fill $name="thead-inner">
    <tr>
      <th rowspan=2 >Task/Skill</th>
      <th colspan=<<ExperiencesCount>> ><<edit-table>></th>
    </tr>
    <tr>
      <$list filter=<<Experiences>> variable="Experience">
        <th><<Experience>></th>
      </$list>
    </tr>
</$fill>
<$fill $name="tbody-inner">
<$list filter=<<tasks>>>
  <tr>
    <td><$link/></td>
      <$list filter=<<Experiences>> variable="Experience">
          <td>
            <$edit field=<<time.estimate.field>> type="number" placeholder=<<Experience>>/>
          </td>
      </$list>
  </tr>
</$list>
</$fill>
</$transclude>
\end table-edited
\procedure table-displayed()
<$transclude $variable="table-template">
<$fill $name="thead-inner">
    <tr>
      <th>Task/Skill</th>
      <th><<edit-table>></th>
      <th>Time Spent</th>
    </tr>
</$fill>
<$fill $name="tbody-inner">
 <$list filter=<<tasks>>>
    <tr>
      <td><<task>></td>
      <td>
        <$select field="time-estimate">
          <$list filter=<<Experiences>> variable="Experience">
            <option value=<<get.time.estimate.field>> ><<Experience>>: <<get.time.estimate.field>>h</option>
          </$list>
        </$select>
      </td>
    <td><$edit field="time-spent" type="number" placeholder="Time Spent"/></td>
    </tr>
  </$list>
</$fill>
</$transclude>
\end table-displayed

<!-- 🎨Styling -->
\procedure style()
<style>
table {
  width: 100%;
  caption{
    caption-side: top;
  }
  select {
    width: 100%;
  }
  [type="text"],
  [type="number"] {
    width: 100%;
    field-sizing: content;
  }
  button {
    width: 100%;
    &[disabled] {
      border: highlight solid 1px;
      background: unset;
    }
  }
}
</style>
\end style

<!-- 📃body -->

<$let 
tasks="[list[]]:sort[tag[done]]"
edit-table-data={{!!edit-table-data}}
Experiences="Novice Beginner Intermediate Advanced" 
ExperiencesCount={{{ [enlist<Experiences>count[]] }}}
add-hours={{{
[{Profile!!practical-experience}compare:number:gt[12]then[0]]
[{Profile!!practical-experience}compare:number:gteq[6]compare:number:lteq[12]then[10]]
[{Profile!!practical-experience}compare:number:gt[0]compare:number:lt[6]then[30]]
:else[[50]]
}}}
>

<%if [<edit-table-data>match[true]] %><<table-edited>><%else%><<table-displayed>><%endif%>

</$let>
\end table

<<table>>

[[Strategy for Study]]

I’m considering whether adopting a systematic emoji-based naming convention for pragmas and sections might help readability. For instance:

• Pragma: \define : (definition)

• Pragma: \function : (perform work)

• Pragma: \import : (for variables to be imported)

• Pragma: \parameters : (variable data)

• Pragma: \procedure : (steps or instructions)

• Pragma: \widget : (modular component)

• Sub Sections:

  • for logic
  • for markup
  • for styling
  • for assembling all parts together

Additionally, using for comments that explain code logic might be useful:

\function .ℹ️() [all[]]
<$list filter="
[[HelloThere]]  [.ℹ️[This is a comment]]
" />

Original idea taken here: How to add "comments" to filter expressions - #7 by Yaisog

I’m not entirely sure if this approach is practical or accessible, but it seems to me like it could improve the user experience for those comfortable with emoji cues. Given your interest in UX (like your thoughtful approach to the save button icon), I’d be very curious to hear your opinion. If this is off-topic, let me know and I’ll start a new thread.