sourcebots / volunteer-docs

Documentation and Information for Volunteers
https://volunteering.sourcebots.co.uk
1 stars 1 forks source link

Robotd Info Page #41

Open trickeydan opened 6 years ago

trickeydan commented 6 years ago

As discussed in #35, we need to define the scope of the "Tour of Code" section of the volunteer-docs. Thus, I have partially written a page on robotd as an example of what would be put there.

Open to feedback and suggestions to help develop this page and section into a useful resource alongside the code comments.

trickeydan commented 6 years ago

docs

Netlify appears to have rendered the tables incorrectly. Should look like this.

PeterJCLaw commented 6 years ago

@trickeydan the mis-render is a result of the version of hugo which we've specified differing from your development environment. Using 0.33, I get the same render as on netlify.

I suggest either (separately) bumping the version to one which supports this or altering this PR to use a different approach.

Note that this simpler syntax does work:

      {{ if .class.inherits }}
        ...
      {{ end }}
      {{ if .class.subclasses }}
        ...
      {{ end }}
PeterJCLaw commented 6 years ago

Thanks for putting this up, I do appreciate the effort. This content looks good, however my concerns from #35 remain. I've opened #43 to discuss that aspect as an issue is probably a better place for that than on the related PRs.