2021-06-18 09:31:21 <RickCarlino[m]> Well I guess I will use Matrix. My IRC client no longer wants to connect to Libera. Strange.
2021-06-18 09:32:10 <eli_oat     > oh weird -- I've had issues where I have to try to connect 2 or 3 times
2021-06-18 09:32:25 <crc         > odd
2021-06-18 09:32:35 <RickCarlino[m]> Mine just refuses. Started two days ago.
2021-06-18 09:32:43 <RickCarlino[m]> Oh well. Matrix is OK I guess.
2021-06-18 09:33:10 <RickCarlino[m]> crc: I have been thinking about the terms/vocabulary used in the handbook for devices. It seems like ID and identifier are used to refer to two different things, right?
2021-06-18 09:33:45 <RickCarlino[m]> Perhaps the vocabulary could be improved some, in the same way the word "sigil" was recently introduced (which was an improvement IMHO).
2021-06-18 09:34:09 <crc         > yes
2021-06-18 09:34:22 <crc         > I'll work on this
2021-06-18 09:34:57 <RickCarlino[m]> I think "class" might be a better term than identifier, but that term may be over loaded or lead folks the wrong way if they start thinking about OOP
2021-06-18 09:35:11 <crc         > it's the downside to docs that grew out of misc. notes I've written out over many years :)
2021-06-18 09:35:39 <RickCarlino[m]> Hah, well I actually think they are pretty good- probably the best ones I've found on a modern Forth system.
2021-06-18 09:36:11 <RickCarlino[m]> I particularly like the start-to-finish format. I start at the top, read the whole thing, then I am done.
2021-06-18 09:36:41 <RickCarlino[m]> It seems that some handbooks want to also be a set of API docs, and it makes it harder to dive in to the language.
2021-06-18 09:36:52 <eli_oat     > 100%, crc, one of the major draws for me to retro is how well documented it is
2021-06-18 09:37:20 <RickCarlino[m]> Have you thought about the new name at all? The first thing that comes to mind for me is "device class" and "device handle"
2021-06-18 09:38:49 <crc         > that would likely work. I'll revise docs and we can review and see if that clarifies things
2021-06-18 09:39:18 <crc         > documentation is annoying to write, but always valuable to actually have
2021-06-18 09:39:18 <RickCarlino[m]> Sounds good!
2021-06-18 09:39:38 <RickCarlino[m]> Hah, so true.
2021-06-18 09:40:18 <RickCarlino[m]> The other one I like with retro that I think a lot of people miss is `retro-document`.
2021-06-18 11:16:53 <rick_carlino1> Interesting... IRC works at the office.
2021-06-18 11:17:08 <rick_carlino1> I have no idea what happened.