# Typos in User's Manual -\> GitHub repository could help **URL:** \ **Category:** Uncategorized\ **Created:** [August 12, 2022, 11:58am UTC](https://calculix.discourse.group/t/typos-in-users-manual-github-repository-could-help/1207 "2022-08-12T11:58:49Z")\ **Posts on this page:** 17\ **Page:** 1
**Author:** ![OliverKunc](https://avatars.discourse-cdn.com/v4/letter/o/aca169/32.png) [@OliverKunc](https://calculix.discourse.group/u/OliverKunc)\ **Post date:** [August 12, 2022, 11:58am UTC](https://calculix.discourse.group/t/typos-in-users-manual-github-repository-could-help/1207/1 "2022-08-12T11:58:49Z")
I suggest outsourcing the CalculiX User’s Manual source to a GitHub repository. Then, the community could be leveraged to enhance it via Pull Requests. I understand that documentation can be a tedious and never-ending work. This and the fact that many users are (proof-)reading it (because it essential to the users) make it a perfect candidate for community suggestions. It is a very good user’s manual already! It is suited for both CalculiX-beginners as well as advanced users, comprehensive and well-written. But for example, there are quite a few typos, both minor and major (such as wrong signs of variables). Also, in my opinion there are improvements to be made concerning the link to examples, the repetitive descriptions of the different solvers for different analysis types, etc. What do you think of this idea? ---
**Author:** ![Calc\_em](https://avatars.discourse-cdn.com/v4/letter/c/43a26b/32.png) [@Calc\_em](https://calculix.discourse.group/u/Calc_em)\ **Post date:** [August 12, 2022, 12:23pm UTC](https://calculix.discourse.group/t/typos-in-users-manual-github-repository-could-help/1207/2 "2022-08-12T12:23:27Z")
> [@OliverKunc](#): > > What do you think of this idea? The idea is good but the problem is that the devs likely don’t want to spend time reviewing PRs on GitHub. The situation is similar with the solver itself - we report bugs here but many of them seem to go unnoticed and it would be great to have the possibility to report them directly on GitHub (after discussing here) with responses from the devs. But again - someone would have to maintain such repository. Currently, GitHub is used only as archive for ccx releases: [https://github.com/Dhondtguido/CalculiXarchive](https://github.com/Dhondtguido/CalculiXarchive) ---
**Author:** ![jbr](https://avatars.discourse-cdn.com/v4/letter/j/ecccb3/32.png) [@jbr](https://calculix.discourse.group/u/jbr)\ **Post date:** [August 13, 2022, 4:20am UTC](https://calculix.discourse.group/t/typos-in-users-manual-github-repository-could-help/1207/3 "2022-08-13T04:20:29Z")
I agree with you @Calc_em - Many bug reports go unnoticed. I’m not sure what is the best way to support the development team, but certainly, GitHub is a great candidate for this work. ---
**Author:** ![Fabrice](https://avatars.discourse-cdn.com/v4/letter/f/5fc32e/32.png) [@Fabrice](https://calculix.discourse.group/u/Fabrice)\ **Post date:** [August 19, 2022, 10:11am UTC](https://calculix.discourse.group/t/typos-in-users-manual-github-repository-could-help/1207/4 "2022-08-19T10:11:11Z")
I believe it is a good idea. We, users, could set up a _user repository_ with: - **Examples of files** for CCX and CGX for the benefit of other users as @mkraska did. - **Examples of configuration files** (_.cgx_ for examples) or _make_ files if it is relevant. - **Links to other tools/sites relevant for Calculix** (Pastix, Windows build, etc.) - **Gather issues for both documentation and code** for CCX and CGX. This would allow a tracking for the users without duplicating topics nor searching on the whole discourse posts, asking for new features, proposing improvements on documentations. **The management of issues would be supported with tags for CCX and CGX, code, documentation, new feature, etc. This would allow Klaus and Guido to filter easily by topics.** The purpose it not to add work on their side… Discourse would remain the forum for discussion for improvement, support to users, etc. and this repository (Github, Gitlab or similar) would be a (better ?) channel to communicate for improvements for both codes and documentations. @dhondt and @klaus.wittig, feel free to react. ---
**Author:** ![Calc\_em](https://avatars.discourse-cdn.com/v4/letter/c/43a26b/32.png) [@Calc\_em](https://calculix.discourse.group/u/Calc_em)\ **Post date:** [August 19, 2022, 10:57am UTC](https://calculix.discourse.group/t/typos-in-users-manual-github-repository-could-help/1207/5 "2022-08-19T10:57:02Z")
Yes, that would be great. Exemplary file sections could become a bit messy if not limited and standardized somehow. But issues sections would be crucial. Issue management works really well on GitHub. I will be glad to help with that. A few days ago, I’ve sent an e-mail to Dr Dhondt to share the file triggering a bug in distributing coupling but I’ve also mentioned other topics, including this potential GitHub repository for issues. I’ll let you know if I get the reply. ---
**Author:** ![Fabrice](https://avatars.discourse-cdn.com/v4/letter/f/5fc32e/32.png) [@Fabrice](https://calculix.discourse.group/u/Fabrice)\ **Post date:** [August 25, 2022, 8:27pm UTC](https://calculix.discourse.group/t/typos-in-users-manual-github-repository-could-help/1207/6 "2022-08-25T20:27:24Z")
There is already a hub for CCX related repositories at [CALCULIX · GitHub](https://github.com/calculix). So we would add a link to a documentation repository there ? ---
**Author:** ![jbr](https://avatars.discourse-cdn.com/v4/letter/j/ecccb3/32.png) [@jbr](https://calculix.discourse.group/u/jbr)\ **Post date:** [August 26, 2022, 12:37am UTC](https://calculix.discourse.group/t/typos-in-users-manual-github-repository-could-help/1207/7 "2022-08-26T00:37:23Z")
@Fabrice , the hub you referenced is not necessarily one the developers use. At least, to my understanding. ---
**Author:** ![Fabrice](https://avatars.discourse-cdn.com/v4/letter/f/5fc32e/32.png) [@Fabrice](https://calculix.discourse.group/u/Fabrice)\ **Post date:** [August 26, 2022, 8:01pm UTC](https://calculix.discourse.group/t/typos-in-users-manual-github-repository-could-help/1207/8 "2022-08-26T20:01:21Z")
I know, the development of CCX and CGX is not open to public contributions as gitXXX platforms. The idea of the repository for documentation is an improvement of current process : sending emails, posts in YahooGroup (before), posts in Discourse (now). Posts are not structured, it may not be easy to scroll and filter through dozens of posts and many users can make the same suggestions without noticing. If there is a dedicated repository, I assume it will be easier but I cannot speak for the developers. ---
**Author:** ![dhondt](https://avatars.discourse-cdn.com/v4/letter/d/7bcc69/32.png) [@dhondt](https://calculix.discourse.group/u/dhondt)\ **Post date:** [September 8, 2022, 9:34pm UTC](https://calculix.discourse.group/t/typos-in-users-manual-github-repository-could-help/1207/9 "2022-09-08T21:34:49Z")
Dear CalculiX users, I plan to create a CalculiXSource and a CalculiXDoc repository in the coming weeks. These will contain the daily changes I make to both the source and the documentation. CalculiXTest may follow. Feel free to comment. Best Greetings, Guido ---
**Author:** ![jbr](https://avatars.discourse-cdn.com/v4/letter/j/ecccb3/32.png) [@jbr](https://calculix.discourse.group/u/jbr)\ **Post date:** [September 9, 2022, 1:50am UTC](https://calculix.discourse.group/t/typos-in-users-manual-github-repository-could-help/1207/10 "2022-09-09T01:50:57Z")
> [@dhondt](#): > > Feel free to comment. Looking forward to contributing to the community! Thank you! ---
**Author:** ![Calc\_em](https://avatars.discourse-cdn.com/v4/letter/c/43a26b/32.png) [@Calc\_em](https://calculix.discourse.group/u/Calc_em)\ **Post date:** [September 9, 2022, 7:38am UTC](https://calculix.discourse.group/t/typos-in-users-manual-github-repository-could-help/1207/11 "2022-09-09T07:38:48Z")
Great decision, I also can’t wait to contribute to issue reports section which will be important part of these repositories (especially the one for ccx source). ---
**Author:** ![imirzov](https://yyz2.discourse-cdn.com/free1/user_avatar/calculix.discourse.group/imirzov/32/1304_2.png) [@imirzov](https://calculix.discourse.group/u/imirzov)\ **Post date:** [September 9, 2022, 8:02pm UTC](https://calculix.discourse.group/t/typos-in-users-manual-github-repository-could-help/1207/12 "2022-09-09T20:02:24Z")
Dear all, I maintain CalculiX organization on the GitHub. And famous Martin Kraska is among the members. If you’d like to join - please, let me know by private message. I need your GitHub user name to send the invitation. Dear Guido, I was waiting for you to start using GitHub since 2018. Great decision! It will drastically increase the speed and quality of the development process. By the way, it would be much better, if you create repos for CalculiX sources and documentation directly in the organization: > **[CALCULIX](https://github.com/calculix/)** > > Developers area of CalculiX Finite Element Software - CALCULIX And, please, use shorter URLs, for example: ```auto github.com/calculix/ccx github.com/calculix/cgx github.com/calculix/doc github.com/calculix/tests etc. ``` ---
**Author:** ![imirzov](https://yyz2.discourse-cdn.com/free1/user_avatar/calculix.discourse.group/imirzov/32/1304_2.png) [@imirzov](https://calculix.discourse.group/u/imirzov)\ **Post date:** [September 9, 2022, 8:06pm UTC](https://calculix.discourse.group/t/typos-in-users-manual-github-repository-could-help/1207/13 "2022-09-09T20:06:59Z")
@Fabrice, there already exist some GitHub repos with CalculiX examples: > **[GitHub - calculix/CalculiX-Examples: CalculiX examples by Prof. Martin Kraska...](https://github.com/calculix/CalculiX-Examples)** > > CalculiX examples by Prof. Martin Kraska from Brandenburg University of Applied Sciences. Excellent starting point to master parametric modelling with CGX and CCX. - GitHub - calculix/CalculiX-Exam... > **[GitHub - calculix/examples: Official and user examples for CCX and CGX. All...](https://github.com/calculix/examples)** > > Official and user examples for CCX and CGX. All in one place. Do not hesitate to add yours. - GitHub - calculix/examples: Official and user examples for CCX and CGX. All in one place. Do not hesita... > **[GitHub - calculix/Muti-Examples: CalculiX Benchmark Studies and Examples by...](https://github.com/calculix/Muti-Examples)** > > CalculiX Benchmark Studies and Examples by Suleyman Muti - GitHub - calculix/Muti-Examples: CalculiX Benchmark Studies and Examples by Suleyman Muti Please, register on GitHub and contribute! ---
**Author:** ![Matej](https://avatars.discourse-cdn.com/v4/letter/m/a698b9/32.png) [@Matej](https://calculix.discourse.group/u/Matej)\ **Post date:** [October 14, 2022, 8:13am UTC](https://calculix.discourse.group/t/typos-in-users-manual-github-repository-could-help/1207/14 "2022-10-14T08:13:26Z")
I am not sure now where to post the typos in the documentation. In documentation 2.20 on page 402 the example should contain the required parameter TYPE, which is currently missing. ---
**Author:** ![Calc\_em](https://avatars.discourse-cdn.com/v4/letter/c/43a26b/32.png) [@Calc\_em](https://calculix.discourse.group/u/Calc_em)\ **Post date:** [October 14, 2022, 8:57am UTC](https://calculix.discourse.group/t/typos-in-users-manual-github-repository-could-help/1207/15 "2022-10-14T08:57:21Z")
Guido recently created a new repository for source code where we can report bugs in the solver. He said that the repository for documentation will follow: [CalculiX source code repository - #3 by dhondt](https://calculix.discourse.group/t/calculix-source-code-repository/84/3) ---
**Author:** ![andnee](https://avatars.discourse-cdn.com/v4/letter/a/87869e/32.png) [@andnee](https://calculix.discourse.group/u/andnee)\ **Post date:** [May 29, 2024, 8:57am UTC](https://calculix.discourse.group/t/typos-in-users-manual-github-repository-could-help/1207/16 "2024-05-29T08:57:00Z")
I am not sure the documentation repository has been created but this is just to point out that in the ccx 2.21 documentation ( USER’S MANUAL) some material, including the bibliography, seems to be missing from the table of contents. I guess adding hyperref at latex compilation would help with hyperlinks. ---
**Author:** ![OliverKunc](https://avatars.discourse-cdn.com/v4/letter/o/aca169/32.png) [@OliverKunc](https://calculix.discourse.group/u/OliverKunc)\ **Post date:** [July 15, 2024, 1:09pm UTC](https://calculix.discourse.group/t/typos-in-users-manual-github-repository-could-help/1207/17 "2024-07-15T13:09:15Z")
Hi @andnee, welcome to this community! Since the creation of this thread, a common repository for both the code and the documentation has been created. The documentation is here: [CalculiX/doc/CalculiX.tex at master · Dhondtguido/CalculiX · GitHub](https://github.com/Dhondtguido/CalculiX/blob/master/doc/CalculiX.tex) But the point of the above discussion is still valid: pull requests need to be reviewed, which is a matter of capacity. Also, hyperref is used and it works in my PDF.