Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Please make README.md a little more elaborate #2

Open
5 tasks done
luzpaz opened this issue Jun 13, 2019 · 6 comments
Open
5 tasks done

Please make README.md a little more elaborate #2

luzpaz opened this issue Jun 13, 2019 · 6 comments
Assignees

Comments

@luzpaz
Copy link

luzpaz commented Jun 13, 2019

Hi @JiriValasek
This looks awesome. Are you aware of the other workbenches that have similar functionality? How does this workbench differ?

Also can you add:

  • License info to README
  • Screenshots and/or short animated gifs
  • Installation instructions
  • a place on the forum that users/testers could give you feedback beside the issue queue of this repo
  • Add topics (aka tags) to this repo like freecad workbench addon animation etc...
@JiriValasek
Copy link
Owner

Hi @luzpaz,
thanks, I've looked into several similar workbenches, but they usually missed some key component I need for my project. Also, some seemed quite complicated with few comments, little documentation.

I know about all the things you mentioned, they are on the list to be done after the code is finished or sometime before that. I wouldn't have gone public before finishing if I had not needed access to GitHub pages to be able to start working on documentation.

Anyway thanks for the feedback, I'll add those things in the near future.

@JiriValasek JiriValasek pinned this issue Jun 13, 2019
@JiriValasek JiriValasek self-assigned this Jun 13, 2019
@JiriValasek JiriValasek reopened this Jun 26, 2019
@JiriValasek
Copy link
Owner

JiriValasek commented Oct 3, 2019

Hi @luzpaz,
I finally finished all the requested things in your issue. What do you think of them?

@luzpaz
Copy link
Author

luzpaz commented Oct 3, 2019

Very cool. you did a lot of work there.
some feedback:

  1. (referring to the getting started page) The yellow headers and some of the usage of lighter colors on that page are hard to read with the white background. something should either change, the background or the color scheme.
  2. There is an interest to provide an abridged version, of what you've written in the website, in the README.md. Because (with your permission, of course) once the workbench is in a state where it can be used, we'd add it to the FreeCAD-addons repo. Which will allow this workbench to be easily downloaded through the FreeCAD Addon Manager. The Addon Manager utilizes thee README.md by displaying it as part of the way users can understand what it does.
  3. in your instructions in how to install your workbench you don't mention that on Linux/MacOS systems FreeCAD has a default ~/.FreeCAD/Mod directory that can be used as a viable location/path to install the workbench in to.
  4. I'm not sure you mention that it's important to stay up to date with you workbench and that users should expect to update the workbench periodically. (this is another reason why point 2, being added to the Addon manager, is convenient because it alerts users when you've updated the repository and a fast way for them to update.)
  5. You also don't mention the ability to use git clone as a convenient method to install the workbench and subsequently keeping up-to-date with it.

@luzpaz
Copy link
Author

luzpaz commented Oct 10, 2019

Also it would be great if you specified, how this workbench compares/differs to other FC animation options available these days:

@luzpaz
Copy link
Author

luzpaz commented Apr 4, 2021

any more progress on this workbench?

@JiriValasek
Copy link
Owner

Not really... Unfortunately, I am kinda low on time to further develop this one.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants