Inbetween contracts over the last year or so I have been beavering away building a CMS with a difference. https://www.graphia.co.uk/ It's aimed at companies that have huge libraries of documents that every employee needs (operating procedures, handbooks, guides, etc) locked away in inflexible propriatory formats (aka Sharepoint/Confluence). * documents are stored in plain text (Markdown) files * the 'database' is a Git repository (but end-users needn't know!) * authors can work online using the web editor (but power users can clone the repo and work in whichever editor they like) * the documentation is 'published' to a static site, the …

Member Avatar
Member Avatar
+0 forum 5

Assume you guys are done with your professional projects. Do you write explanation of working of your projects in the comments in the code. Or do you write entire documentation addressing every variable and function? Or do you do both? If you do both, how do you avoid repeating yourself? After all you're writing the same. If you do either, what are some good examples or thoughts you would share with a newbie who does documentation for first time? I can make it look clean and easily see-through. But beside that?

Member Avatar
Member Avatar
+0 forum 1

Hi all, I would like to learn on the best practices in code nad software documentation. Also would be great to learn about tools if any for this purpose. Thanks and Regards Nagen

Member Avatar
Member Avatar
+0 forum 3

Hello again! I want to understand how a particular software product works. Its a game and its completely moddable (uses lua for its game logic) yet most modders such as myself don't really understand how it all fits together. I asked something similar to this question a few months ago. I got some great answers but what I'm curious about now is if a software product exists which can be useful for organizing and displaying my notes on the source. Ideally it would allow for a "visual map" (a flowchart??) of the files in use and what they and their …

Member Avatar
Member Avatar
+0 forum 1

I just wanted to show the basic usage of docopt, a module that makes parsing command-line arguments so much easier. I'm not affiliated with the creators of docopt, but I'm certainly thankful for their work and happy to post this little snippet. I will point you to [docopt.org](http://docopt.org) for more information because there is so much more you can do with this module, that I'm not showing you here. Watch the video, it was an eye-opener for me. Also, if you'd like to install docopt you can go to their [github repo](https://github.com/docopt/docopt) to download and install it. Try running this …

Member Avatar
+1 forum 0

Hey i just wonder if i can send the method comments with the OperationContract so i see it in my WCF Test Client. that way the php dude can see what each method does and how to work from that. /// <summary> /// Text text /// </summary> /// <param name="Kund"></param> /// <returns></returns> this normal method comment option doesent seems to work for me i might be wrong and just looking wrong in the test client but any advice would be nice :P thank you for answers :)

Member Avatar
+0 forum 0

I have used snippets of code from various sources to compile the following code: import java.awt.*; import java.awt.image.BufferedImage; import java.io.*; import javax.imageio.ImageIO; import javax.swing.JFrame; import java.util.Calendar; public class ShowImage extends Panel { static Calendar cal = Calendar.getInstance(); //gets system time BufferedImage image; private static final String holidaysimages[] = { //declares the image array "santa.jpg", "valentine.jpg", "bunny.jpg", "bunny.jpg", "summer.jpg", "summer.jpg", "summer.jpg", "summer.jpg", "turkey.jpg", "turkey.jpg", "turkey.jpg", "santa.jpg"}; private static final String holidayssounds[] = { //declares the sound array "santa.wav", "valentine.wav", "easter.wav", "easter.wav", "summer.wav", "summer.wav", "summer.wav", "summer.wav", "turkey.wav", "turkey.wav", "turkey.wav", "santa.wav"}; public ShowImage() throws Exception { try { String imageName= holidaysimages[cal.get(Calendar.MONTH)]; //uses the …

Member Avatar
Member Avatar
+0 forum 1

I am new to learning assembly language. I wanted to know if using HLA assembler by Randall Hyde would be a good option for a beginner like me? It seems good on documentation and educational material available on author's site but i wanted to take recommendations from you guys on which would be the best assembler for a beginner. PS- I also have fair knowledge of c++ and java (but not advanced).

Member Avatar
+0 forum 0

Hi guys, I'm looking for a little help with Apache Xerces. I am currently trying to use Xerces-C++, but I'll soon be using Xerces-Java. As I look the the C++ programming guide and the DOM programming guide, a lot of my questions remain unanswered. The sample codes lack comments on things that are confusing to me, and important options are not explained in the API as to why or why not you might want to you use them. There also doesn't seem to be much information on best practices or what is/isn't efficient. I'm hoping to get the help of …

Member Avatar
+0 forum 0

I am VERY confused by the Doxygen configuration file. I cant seem to figure out how to make it compile code between [ICODE]#ifdef __cplusplus[/ICODE] and [ICODE]#endif[/ICODE] Also I dont understand how to change what it does with preprocessor symbols or how to make it NOT generate documentation on something. Any help would be appreciated.

Member Avatar
Member Avatar
+0 forum 3

Hello fellow Daniwebbers, I have a question about choosing a CMS. I know what you're think "OMG another 'what cms' thread". Hold yer ponies because I want to be very clear and precise. Having worked with multiple CMSs over the years, I have acquired a knowledge of which CMSs are best at what. Wordpress = small sites/blogs, Drupal = anything, and joomla = small sites/news sites. What I want to do is create a cool site where users can just post documentation and tutorials on specific subjects. I don't want it to be a forum, just a strict documentation center. …

Member Avatar
Member Avatar
+0 forum 2

In Ubuntu Is there any package which enables to view different 'C' command syntaxes. I am tired of 'man sprintf',man **** commands. Is there any GUI interface?

Member Avatar
+0 forum 0

The End.