Documentation To-Do

Post Reply
User avatar
4I1RAC
Posts: 142
Joined: Thu Nov 28, 2019 5:25 am
Location: Philippines
Contact:

Documentation To-Do

Post by 4I1RAC » Wed Jan 15, 2020 8:54 am

It's been a while since I made major contributions to the documentation. I hope I have not lost track of the latest changes and developments (that was mid-December).

I've setup a WiKi on Github to keep track of the things I need to address in the documentation. Please remind me if I've forgotten some -- either on GitHub or here.

https://github.com/jangelor/OpenGD77/wi ... ation-ToDo

Developments are quite quick, and documentation can't catch up (kudos to the team for that!). :)
Angelo, 4I1RAC / N2RAC
Brandmeister Philippines support team
Talkgroups
- 51518 crosslinked to DX1ARM 431.600 MHz Fusion repeater, Metro Manila
- 98977 Opengd77
- 515 Philippines

https://n2rac.com

VK3KYY
Posts: 1639
Joined: Sat Nov 16, 2019 3:25 am
Location: Melbourne, Australia
Contact:

Re: Documentation To-Do

Post by VK3KYY » Wed Jan 15, 2020 9:29 am

I think some features that are currently in the radio like Function + 1 = Scan, should not be documented yet, because they are not the final functionality.

Also, for the VFO scan, I think at the moment the user interface , where you must set the Low and High frequencies, probably needs to be improved, e.g. because its not possible to see the Low and High frequency.

However the Hotspot changes I think now stable.

User avatar
4I1RAC
Posts: 142
Joined: Thu Nov 28, 2019 5:25 am
Location: Philippines
Contact:

Re: Documentation To-Do

Post by 4I1RAC » Wed Jan 22, 2020 9:27 am

VK3KYY wrote:
Wed Jan 15, 2020 9:29 am
I think some features that are currently in the radio like Function + 1 = Scan, should not be documented yet, because they are not the final functionality.

Also, for the VFO scan, I think at the moment the user interface , where you must set the Low and High frequencies, probably needs to be improved, e.g. because its not possible to see the Low and High frequency.

However the Hotspot changes I think now stable.
Got it. We should probably have space in the documentation for experimental features or a reference somewhere here in the forum or GitHub that people can check.
Angelo, 4I1RAC / N2RAC
Brandmeister Philippines support team
Talkgroups
- 51518 crosslinked to DX1ARM 431.600 MHz Fusion repeater, Metro Manila
- 98977 Opengd77
- 515 Philippines

https://n2rac.com

kt4lh
Posts: 67
Joined: Sun Jan 12, 2020 4:27 am

Re: Documentation To-Do

Post by kt4lh » Wed Jan 22, 2020 1:02 pm

I was just pondering the same thing the other day about the manual being the long-term functionality, things that are likely not changing, but a supplemental document (or section in the user guide) for ephemeral or experimental changes.

OpenGD77 is moving at a fast pace, which is really nice, just in some weeks of switching I've seen some very nice changes. However there are also some changes that conflict with previous ones, such as hotspot activation, and a single place for users to look for current information would be great.

Perhaps part of the PR process should include updating documentation in one of the two places?

VK3KYY
Posts: 1639
Joined: Sat Nov 16, 2019 3:25 am
Location: Melbourne, Australia
Contact:

Re: Documentation To-Do

Post by VK3KYY » Wed Jan 22, 2020 8:17 pm

The use of SK1 to enable the Hotspot was originally used so that the radio could not accidentally be put into Hotspot mode, because the code was not 100% stable.

However now Daniel has fixed the bugs, it was safe to allow Hotspot mode to be enabled all the time.

I think the only thing which may change, would be the need to select the host type, if BlueDV fixes their differences with MMDVMHost

User avatar
W0RMT
Posts: 218
Joined: Sat Nov 16, 2019 12:45 pm
Location: Melbourne, Australia
Contact:

Re: Documentation To-Do

Post by W0RMT » Thu Jan 23, 2020 2:39 am

4I1RAC wrote:
Wed Jan 15, 2020 8:54 am
It's been a while since I made major contributions to the documentation. I hope I have not lost track of the latest changes and developments (that was mid-December).

I've setup a WiKi on Github to keep track of the things I need to address in the documentation. Please remind me if I've forgotten some -- either on GitHub or here.

https://github.com/jangelor/OpenGD77/wi ... ation-ToDo

Developments are quite quick, and documentation can't catch up (kudos to the team for that!). :)
Good idea!
Bud W0RMT / VK3BUD
Colorado HD BM TG 31088
coloradodigital.net

User avatar
4I1RAC
Posts: 142
Joined: Thu Nov 28, 2019 5:25 am
Location: Philippines
Contact:

Re: Documentation To-Do

Post by 4I1RAC » Thu Jan 23, 2020 5:38 am

Perhaps we can link from the main document (MD and PDF) to a place here on the forums, or even a wiki on github, some experimental or other changes, plus links to where they can be found here on the fourm.
Angelo, 4I1RAC / N2RAC
Brandmeister Philippines support team
Talkgroups
- 51518 crosslinked to DX1ARM 431.600 MHz Fusion repeater, Metro Manila
- 98977 Opengd77
- 515 Philippines

https://n2rac.com

User avatar
W0RMT
Posts: 218
Joined: Sat Nov 16, 2019 12:45 pm
Location: Melbourne, Australia
Contact:

Re: Documentation To-Do

Post by W0RMT » Thu Jan 23, 2020 8:40 am

4I1RAC wrote:
Thu Jan 23, 2020 5:38 am
Perhaps we can link from the main document (MD and PDF) to a place here on the forums, or even a wiki on github, some experimental or other changes, plus links to where they can be found here on the fourm.
That's a good idea, Angelo. Perhaps we need a new section or subsection called "Latest Development" in the User Guide to link to the more up-to-date references on the forum and GitHub wiki.
Bud W0RMT / VK3BUD
Colorado HD BM TG 31088
coloradodigital.net

Post Reply