Skip to content

Integrated language help feature in OpenSCAD #100

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

Open
t-paul opened this issue Feb 9, 2025 · 10 comments
Open

Integrated language help feature in OpenSCAD #100

t-paul opened this issue Feb 9, 2025 · 10 comments

Comments

@t-paul
Copy link
Member

t-paul commented Feb 9, 2025

Outline

Add more interactive help features for built-in functions and modules. Right now there's already a nice summary of parameters linked as cheat sheet. Scope of this projects would be to use this information in extended form and make it available in a more direct way in the editor.

Details

  • Convert the cheat sheet information into machine readable format
  • Find a way to generate the existing HTML format based on the core data
  • Add context help to editor giving help for built-in functions and modules, e.g. by adding formatted help output to the console window, including the links to further documentation like the language manual on Wikibooks

Expected Outcome

Cheat sheet is integrated into the application and additional context help for built-in functions and modules is available.

Project Properties

Skills

  • Programming language is C++
  • GUI programming with the Qt framework

Difficulty

Easy

Size

Medium (175h)

Additional Information

@guptushar27
Copy link

I want to work on this issue. Please Assign this to me.
Thanks

@t-paul
Copy link
Member Author

t-paul commented Feb 10, 2025

@guptushar27 Those projects are planned for GSoC, for how that process works, see https://summerofcode.withgoogle.com/how-it-works and https://opencax.github.io/ - If you want discuss, join the IRC channel, link above.

@siyangwu358
Copy link

How can I join your channel to discuss with you.

@mpark341234567
Copy link

Hi Mentors,

My name is Michael, and I am a second-year community college student. I am interested in this project for GSoC, but unfortunately, I do not know GUI programming. Can I learn GUI before the project starts? Also, I would like to have more information on this project. Thanks!

@t-paul
Copy link
Member Author

t-paul commented Mar 30, 2025

@mpark341234567 As the name Google Summer of Code indicates, it's focus is about coding. If you have some basic knowledge of C++ and only some specifics like the GUI library are new that could be ok, there is also still some time till the project would actually start. Going without any of the skills listed is probably not a good idea, in that case it would be advisable finding a different project with better match.

@mpark341234567
Copy link

Thank you for the clarity! I am currently taking the second-level course on C++ programming, which includes some OOP topics like inheritance and polymorphism. The GUI library, however, is completely new to me. Am I suitable for this project, or should I look for a better match?

@t-paul
Copy link
Member Author

t-paul commented Mar 31, 2025

At this point, it's mostly for you to judge if you feel ready to take on the topic. Maybe take a couple of hours and get the source code and build it. Have a look at the existing code and the running application - see if you have a basic idea what the project would want to achieve (talk to us on IRC for help with that!). If you are ready to write a detailed project proposal based on the information you have collected, and see some direction to start on the code side, then go with it.

@LeulShiferaw
Copy link

I have written in the IRC channel about assigning this project to me. Please let me know if the project has already been taken

@KalpanaBhaskar
Copy link

Hello , I'm Kalpana, an AI undergrad . I've been trying to upload my proposal for this project for a couple days but gsoc page isn't responding. I really want to give this a shot.. is there any way for me to reach out to the team?

@t-paul
Copy link
Member Author

t-paul commented Apr 1, 2025

GSoC FAQ points to: https://developers.google.com/open-source/gsoc/contact - If you have issues with the GSoC website, I'd suggest using the email listed there.

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

No branches or pull requests

6 participants