Hi,
Dec 28, 2020, 04:36 by
fun...@gmail.com:
> Hello,
>
> I found
markdown.org. It seems, newly born again software "expert" here, there are many avenues to take on this venture. CodeLabs does not like me or Ubuntu for some reason.
>
> ...
>
> I can try CodeLabs again under Debian if necessary but it seems that there are many avenues available with markdown. I have been reading and I have used the markdown briefly before reading into it more recently.
>
> If necessary, I can start to transfer specific pages out of your
machinekit.io pages or make new ones for people like me who are new to machinekit.
>
I think making new ones would be the right thing in this, because trying to bend something to own needs is always mildly frustrating and could potentially lead to loss of stamina or interest. When one starts on a green field, everything looks more promising.
This way one can also create something based on his best intentions and knowledge without the need to constantly double-guess what somebody else was thinking.
> I am not sure what is needed right now. I know what I would do but it may not be as professional as some people would like.
>
Professionals are just amateurs who get paid. This is part of what I wanted to say by pointing out that everyone has different vector how to learn this tool. I probably messed my reasoning up.
For me, the most important part was to understand that it is not about CNC or path planning or kernelspace and userspace modules or any of that parts most frequently talked about, but it is about shared memory based IPC, and its functional API. But for somebody else, somebody interested in other areas, it will be different.
So I do think that user description, understanding and on this based tutorials are important. Sure, for somebody it will not be "professional" enough, for somebody else it will be exactly what he was looking for. That's life.
> I would just use markdown to create some simple examples to test. For example, I can try w/ the BBB and learn the commands and publish what I am learning. I have not been around long enough to know every in and out but...
>
Sounds great. Usually people who just recently gained some knowledge are the ones best poised to spread it to others.
> I have a motor
> I have a BBB
> I have some nice source to test the motor
> I can get an image of Machinekit ready to prevail with the BBB image
> Easy to read or black and white text? See me, I am not a popular person nor do I stay accustomed to seizures from lucid colors while reading. I like it plain and simple (one reason google groups is nice). No frills.
>
Sure, that is the advantage of using Markdow or AsciiDoc. These are targeted toward the content and the form can be modified afterwards.
So, you are against the change to something modern, like Discourse?
>
> ...
>
> So, in retrospect, I would say markdown and in an easy-to-read format, i.e. bullet points, some code from testing, some command usage, and outcomes w/ all of that combined into a video for "leverage." People love the final product.
>
Great, videos are nice! Especially from someone who has a pleasant voice.
>
> I have a couple more items to get so I can alter the state of this motor but I will look to machinekit for usage. I am learning currently about machinekit slowly along w/ commands and .ini files for usage on the commands.
>
> Seth
>
> P.S. If you need me to promote my findings on "popular" links about
machinekit.io and the ideas involved, let me know. I will do it. Places like Hackster.io, Hackady.io, Instructables, and places of that nature might bring in some fascination since I cannot really provide high levels of C/C++ source right now. If it works, it works. People who use 32-bit machines should know and I think people should use it based on this info. about it being dedicated to 32-bit machines. Just for the record, I will be posting some files in here regarding my markdown findings on the subject of
machinekit.io and my personal usage. Sorry for the long explanation. Over and out...tutorials on the way!
>
Do what you think is best. I have found that it is the best approach.
Cern.
> On Sunday, December 27, 2020 at 6:02:03 PM UTC-6
ce...@tuta.io wrote:
>
>> >> >> >> > There is no pressure from me. I can learn from the >> >> >> >>
machinekit.io <
http://machinekit.io>>> <>>
http://machinekit.io>> >>> <>> >>
http://machinekit.io>> >> >>> <>> >> >>
http://machinekit.io>> >> >> >>> site like I have been doing. But after a bit of spending time on the site, it is an actually large database. It is easy to use and dedicated to instruction. This is nice.
>> >> >> >> >
>> >> >> >> Most people who I talked about the site said to me that it is chaotic, the tree structure doesn't make sense and finding anything even with a search engine is Herculean task. It is interesting that you find the site fine and definitely something which needs to be taken into consideration.
>> >> >> >>
>> >> >> >> >
>> >> >> >> > I say keep it or are you guys going to rearrange things a bit? I ask b/c some of the ideas are not BBB.io related. I am not affiliated w/ the >> >> >> >>
beagleboard.org <
http://beagleboard.org>>> <>>
http://beagleboard.org>> >>> <>> >>
http://beagleboard.org>> >> >>> <>> >> >>
http://beagleboard.org>> >> >> >>> people but I enjoy using their boards for learning Linux based initiatives.
>> >> >> >> >
>> >> >> >> I would say the biggest problem is the fact that the site still presumes (and gives the impression) that Machinekit is monorepo. It does not differentiate between Machinekit-HAL, MKSoCFPGA, EMCApplication, HAL_ROS_control (when I include the Zultron's project) and other parts.
>> >> >> >>
>> >> >> >> And I hope many ideas are not BBB related. I would hate if people thought that Machinekit is BeagleBone only endeavour.
>> >> >> >>
>> >> >> >> >
>> >> >> >> > I just like motor work, the use of motors, and to mfg. new machines when I can to promote the ideas behind it all. Finding open minds is not easy. People would rather pay for a Arduino w/ a cheap daughter card so that they can put GRBL or Marlin on it. Machinekit is not the same and is highly configurable. This is what I think is nice about the entire set up you guys have in the CNC world.
>> >> >> >> >
>> >> >> >> Well, to be fair, there is a tonnage of interesting ideas in the Arduino world. If it all can be somehow interconnected or reused, the better. In terms of better documentation, getting up some page comparing Arduino products to Machinekit et al. is source of tension than a helpful tool in the long run.
>> >> >> >>
>> >> >> >> Cern.
>> >> >> >>
>> >> >> >> >
>> >> >> >> > But, like my old posts in the field, I say a Cape for the BBB or BBAI would be neat.
>> >> >> >> >
>> >> >> >> > Well, it is late and I have not tested much recently. I just got trying to handle interrupts on some Python3 source via the Motor Bridge Cape, the BBGG, and some other source. Testing will ensue!
>> >> >> >> >
>> >> >> >> > Seth
>> >> >> >> >
>> >> >> >> > P.S. Nothing is final. Things evolve, people take specific routes, and stuff stays the same. MachineKit!
>> >> >> >> > On Monday, November 30, 2020 at 12:54:09 PM UTC-6 >> >> >> >>
ce...@tuta.io <>>> <>>> <>>> <>>> wrote:
>> >> >> >> >
>> >> >> >> >> The was discussion about this problem in the Machinekit chat room. The truth is that the community support in Machinekit is and was not good (being tactful) and with changes in development it only got worse.
>> >> >> >> >>
>> >> >> >> >> The documentation is bad and obsolete, the site itself is pretty chaotic and finding information is almost Sisyphean task. Everybody recognises this.
>> >> >> >> >>
>> >> >> >> >> The changes happening in development on Github were not manually propagated here to Google groups. Moreover, the links at top are again long obsolete in its step-by-step tutorial value (but the overall explanation and goals are still more or less valid). This is a lot more murky than to say "The site needs replacement" - because Machinekit always recognised the need for the user to be proactive and keep a finger on the pulse of development (and encouraged to do some development themselves). No version of Machinekit (meaning Machinekit organization's project here and in whole text) is production ready in the sense of guaranteeing stable version and high level of support. With the understanding that if somebody wants to or need to, he should produce his own stable branch (with implementing upstream changes as he sees fit). That was the status quo for companies using Machinekit in their commercial offerings.
>> >> >> >> >>
>> >> >> >> >> However, the community forum is good for something like user issue sharing, basic supporting questions and proud presentations of own use of Machinekit. Just people should not forget that there is also the Github issue tracker specific to each project used for developer talk (which does not mean that only developers or contributors can comment on presented issues).
>> >> >> >> >>
>> >> >> >> >> This out of the way, let's talk about how to reinvigorate the Machinekit community (because otherwise all this is useless). The website with repository README page are first point of contacts with new users. Usually what I need to know about new OSS is WHAT is it, WHY does it exist, HOW can I use it and WHEN should I use it.
>> >> >> >> >>
>> >> >> >> >> Current status of Machinekit site did not change much from the time Machinekit was forked. It is Jekyll based site with own theme build from Machinekit-docs repository with use of Github Actions service and deployed to >> >> >> >> >>
Machinekit.github.io <
http://Machinekit.github.io>>> <>>
http://Machinekit.github.io>> >>> <>> >>
http://Machinekit.github.io>> >> >>> <>> >> >>
http://Machinekit.github.io>> >> >> >>> <>> >> >> >>
http://Machinekit.github.io>> >> >> >> >>> repository as Github Pages. I think this is a nice setup. (Not the Jekyll part, I don't care if Hugo, Gridsome, Docusaurus or whatever else is used, but the fact that it is basically static site which can be hosted pretty much anywhere and quickly replicated in case of problem by anybody.) The build is based on a very precarious Docker image (which is based on Debian Jessie and cannot be rebuilt anymore). And some parts are broken and no longer building. In other word, bad.
> To view this discussion on the web visit >
https://groups.google.com/d/msgid/machinekit/03d9fb4d-e53b-4c3f-ae70-685a2d1f1e6an%40googlegroups.com <
https://groups.google.com/d/msgid/machinekit/03d9fb4d-e53b-4c3f-ae70-685a2d1f1e6an%40googlegroups.com?utm_medium=email&utm_source=footer>> .
>