[MacPorts] #55448: Document github portgroup in guide (was: MacPorts guide makes no mention of livecheck built-in functionality for github)

[MacPorts]

#55448: Document github portgroup in guide
---------------------------+-----------------
  Reporter:  emcrisostomo  |      Owner:
      Type:  defect        |     Status:  new
  Priority:  Normal        |  Milestone:
 Component:  guide         |    Version:
Resolution:                |   Keywords:
      Port:                |
---------------------------+-----------------

Old description:

> While updating the sysutils/fswatch port, I decided to add the livecheck
> configuration. I searched the guide (section 5.8) to see whether there
> was some builtin functionality for github but the only mentions I found
> are referring to mirror sites (freecode.com, sourceforge.net,
> /code.google.com). A search came up with the following MacPorts ticket:
>
> https://trac.macports.org/ticket/53940
>
> As suggested in this ticket, I tried to simply add the following line to
> the Portfile and it appears to be working fine:
>
> livecheck.url   ${github.homepage}/releases/latest
>
> Shouldn't the guide be updated in order to reflect this feature? I
> believe this is an important feature, given the relevance of Github
> nowadays.

New description:

 While updating the sysutils/fswatch port, I decided to add the livecheck
 configuration. I searched the guide (section 5.8) to see whether there was
 some builtin functionality for github but the only mentions I found are
 referring to mirror sites (freecode.com, sourceforge.net,
 /code.google.com). A search came up with the following MacPorts ticket:

 #53940

 As suggested in this ticket, I tried to simply add the following line to
 the Portfile and it appears to be working fine:

 {{{
 livecheck.url   ${github.homepage}/releases/latest
 }}}

 Shouldn't the guide be updated in order to reflect this feature? I believe
 this is an important feature, given the relevance of Github nowadays.

--

Comment (by ryandesign):

 Yes, the github portgroup is not documented in the guide. Yes, it should
 be.

 For now, the only documentation for the github portgroup is in comments in
 [browser:macports-ports/_resources/port1.0/group/github-1.0.tcl the
 portgroup file itself].

--
Ticket URL: <https://trac.macports.org/ticket/55448#comment:1>
MacPorts <https://www.macports.org/>
Ports system for macOS