Contributor jeypeyy on the Programming category
contributing to packages in Synaptic is slow
Written by deltrem the 9 Jun 10 at 01:33.
Related project: Synaptic package manager .
New
There are so many interesting projects in Synaptic... So currently, I have to search for a package title in Google, find the package page, find the package repository, if it's a version control system I know, download the source code, if they're programming languages I know, contribute. What if you like few version control systems or like few programming languages? Please, imagine what happens!
Difficult to understand source code
Written by Eldmannen the 29 Mar 09 at 05:44.
Global category: Programming.
New
Many people and programmers wish to dive into the source code of software to improve it.
Open source is great, but programming can be difficult and daunting because often the code may appear complex. Analyzing it can be very time consuming and daunting.
People may have difficulties in understanding the source code and getting involved with the development.
Solution #1:
Encourage developers to comment the code
I've noticed that some code contain almost no comments at all (example Compiz).
Which makes it difficult to understand what the functions and sometimes variables are used for. Sometimes functions call other functions which call other functions, which makes it a bit of a maze to grasp.
I think that developers should be encouraged to comment their source code. It can also be a good way for novices to help out, who understand the code, but may not be confident in their skills to write code.
I've noticed that some code contain almost no comments at all (example Compiz).
Which makes it difficult to understand what the functions and sometimes variables are used for. Sometimes functions call other functions which call other functions, which makes it a bit of a maze to grasp.
I think that developers should be encouraged to comment their source code. It can also be a good way for novices to help out, who understand the code, but may not be confident in their skills to write code.
Solution #2:
Get all the source code indexed by Google Codesearch
Get all the source code for all software in the Ubuntu repository indexed by
Google Code Search .
This makes it easier to search through source code, packages, etc, and also re-use code.
Get all the source code for all software in the Ubuntu repository indexed by <a href="http://www.google.com/codesearch">Google Code Search</a>.
This makes it easier to search through source code, packages, etc, and also re-use code.
Solution #3:
Generate documentation
Use a documentation generator (such as
Doxygen ,
HeaderDoc ,
Javadoc , etc) to automatically generate documentation for all software in the repository.
Use a documentation generator (such as <a href="http://en.wikipedia.org/wiki/Doxygen">Doxygen</a>, <a href="http://en.wikipedia.org/wiki/HeaderDoc">HeaderDoc</a>, <a href="http://en.wikipedia.org/wiki/Javadoc">Javadoc</a>, etc) to automatically generate documentation for all software in the repository.
Solution #8:
Develop tiered standards and apply gentle pressure
I think developers would be greatly encouraged to comment/explain there code in some way if there was a standard system for doing so.
The system would obviously have to have tiers as not every kind of explanation would be suitable for a given package.
Developers could then be encouraged to use the system.
I think developers would be greatly encouraged to comment/explain there code in some way if there was a standard system for doing so.
The system would obviously have to have tiers as not every kind of explanation would be suitable for a given package.
Developers could then be encouraged to use the system.
Solution #9:
Promote distributed source control; bzr, git, mercurial over older methods.
The best way to learn about the most important parts of an application are to watch the changes that other developers make. Having not just the dead source code but also the very development history itself is key to a greater understanding of the source code itself, and is a natural workflow that adds to understanding on top of in-code-comment documentation.
For an example of the power of distributed source control, (git in this case), check out any popular source code repository on github.com.
The best way to learn about the most important parts of an application are to watch the changes that other developers make. Having not just the dead source code but also the very development history itself is key to a greater understanding of the source code itself, and is a natural workflow that adds to understanding on top of in-code-comment documentation.
For an example of the power of distributed source control, (git in this case), check out any popular source code repository on github.com.
Python debugger as Gedit plugin
Written by rmyeid the 12 Dec 08 at 00:00.
Related project: Gnome .
New
Gedit is simple editor which is powerful using the various plugins it has. I think python is a great language lacks an easy to use visual debugger. I used gedit latex plugin which was really cool, even it has memory leaks [
http://live.gnome.org/Gedit/LaTeXPlugin].
My idea shortly, I am enthusiastic to see a python debugger in gedit. I don't have experience in gnome development. However, I am ready to work on that If I got simple guidelines and support[any type of mentorship you like].
Solution #1:
Auto-generated solution of idea #16437
Written by
rmyeid the 12 Dec 08 at 00:00.
Ubuntu Brainstorm was updated in January 2009. Since the
idea #16437 was submitted before this update, its rationale and solution are not separated. Please vote accordingly, and if you have the necessary rights, please separate the rationale from the solution. Thanks!
<i>Ubuntu Brainstorm was updated in January 2009. Since the idea #16437 was submitted before this update, its rationale and solution are not separated. Please vote accordingly, and if you have the necessary rights, please separate the rationale from the solution.</i><br /> Thanks!
Solution #2:
Notify the user of plugins they might be interested in
Written by
Endolith the 15 Apr 09 at 14:26.
When you open a file in a certain language in Gedit, it should have a very unobtrusive thing show up, that indicates "there are specialized plugins for this language, do you want to look through them and install any?"
Maybe a drop-down notification like it shows when you open a file it can't understand.
Maybe just an icon that appears in the toolbar?
Maybe a libnotify OSD thing would be better.
When you open a file in a certain language in Gedit, it should have a very unobtrusive thing show up, that indicates "there are specialized plugins for this language, do you want to look through them and install any?"
Maybe a drop-down notification like it shows when you open a file it can't understand.
Maybe just an icon that appears in the toolbar?
Maybe a libnotify OSD thing would be better.
Need for visual descriptions in source code comments
Written by hijstr the 19 Jan 09 at 02:38.
Global category: Programming.
New
When writing source code, it good practice to precede functions etc with a description of what that code does in comments. Unfortunately, a lot of the time it is difficult to put into words exactly what that functionality is.
Personally, I find things a lot easier to understand when they are drawn out in front of me. (everyone knows the best ideas are scribbled on the back of napkins etc)
This is particularly apparent when you are maybe trying to explain how a certain data structure works, or the way in which objects in a program interact.
Solution #1:
Embedding images within the code that are expanable upon clicking
Written by
hijstr the 19 Jan 09 at 02:38.
For anyone who uses Photoshop, they may have used the tag feature, where you can attach a pop up text box to a region of the image. This is the idea I have in mind (albeit in complete reverse).
The user could attach images to comments in the code. Every image saved would appear in the code as a small icon, and when clicked, expands into an image.
The image could be created on the fly by a pop-up drawing box, so other programs would not need to interact(alternatively, the user could opt to embed an image that is already on the disk). As drawing with a mouse is notoriously difficult, templates could be provide (like in the program Dia) for arrows, boxes, and other UML-like images.
The real consideration is how to embed these images, would the be embedded into the actual source file, would you need to create a completely new filetype, would the images accompany the source code - leaving the implementation of the idea completely down to the IDE? I don't know, but I think as a whole it would be a nice feature to look into
For anyone who uses Photoshop, they may have used the tag feature, where you can attach a pop up text box to a region of the image. This is the idea I have in mind (albeit in complete reverse).
The user could attach images to comments in the code. Every image saved would appear in the code as a small icon, and when clicked, expands into an image.
The image could be created on the fly by a pop-up drawing box, so other programs would not need to interact(alternatively, the user could opt to embed an image that is already on the disk). As drawing with a mouse is notoriously difficult, templates could be provide (like in the program Dia) for arrows, boxes, and other UML-like images.
The real consideration is how to embed these images, would the be embedded into the actual source file, would you need to create a completely new filetype, would the images accompany the source code - leaving the implementation of the idea completely down to the IDE? I don't know, but I think as a whole it would be a nice feature to look into