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 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 yes

2021-06-18 09:34:22 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 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 that would likely work. I'll revise docs and we can review and see if that clarifies things

2021-06-18 09:39:18 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.