[Sugar-devel] Comments in code [ Gonzalo Odiard ]
Hello I have found that the functions that show content and objects in the develop activity are in sugar-build/activities/develop-activity/develop_app.py and sugar-build/activities/develop-activity/sourceview_editor.py files In def save_source_jobject function in develop_app.py, there is a comment: # dict.update method is missing =( What is this comment referring to? And what is the dictionary update method supposed to do? Can someone please help? I need to update the icon on altering the .svg file and feeling lack of proper comments there in the code. Or please point me to some documentation where there each function will be defined. How can I get what is done where? Even there are functions that don't have a single comment. The coding standard tell to add description in quotes that make the documentation using some software. About each and every function comments should be there. Please help, I'm stuck. -- Kamaljeet Kaur kamalkaur188.wordpress.com I am not what I am compared to others, I am what I am compared to my yesterday. ___ Sugar-devel mailing list Sugar-devel@lists.sugarlabs.org http://lists.sugarlabs.org/listinfo/sugar-devel
Re: [Sugar-devel] Comments in code [ Gonzalo Odiard ]
On Wed, Apr 2, 2014 at 5:41 PM, Gonzalo Odiard godi...@sugarlabs.org wrote: The comment is old, very old, (you can learn to use git blame to get the changes in context. I assume the programmer wanted a method to update a dict based in the content of another. Yes, I have heard of git blame, will use it now. snip True, not much documentation in the code. We don't use comments in every function or method, and the code should be easy to read, May be I'm wrong but with comments and descriptions, I think, it becomes easy to understand the working for newbies. Assuming that the person reading the code knows nothing about what it's supposed to do. Comments then can explain every step of the way. Sorry to say but I think well commented functions will make the code easy to read. Correct me if I am wrong. but honestly Develop was unmaintained for a long time, I started a few months ago to put it in shape to be used again. Yes, I know and that's what we are here for :) Sugar is our baby and we are nourishing it :D Sorry, I can't help you much more. No worries :) If you are stuck with this task, maybe can look at other easier bugs http://wiki.sugarlabs.org/go/Activities/Develop#Pending_tasks Thanks for the useful link. But now that I have shared my problem and have spent a couple of days with it. I think, I should not let go that efforts in vain before getting the output. Otherwise it can make me feel depressed ;) And it's a problem with understanding only. Everything is there, I'm trying again with some other approach :) Thanks for being there and for that precious reply :) -- Kamaljeet Kaur kamalkaur188.wordpress.com I am not what I am compared to others, I am what I am compared to my yesterday. ___ Sugar-devel mailing list Sugar-devel@lists.sugarlabs.org http://lists.sugarlabs.org/listinfo/sugar-devel
[Sugar-devel] Fwd: Comments in code [ Gonzalo Odiard ]
On Wed, Apr 2, 2014 at 9:10 PM, Gonzalo Odiard godi...@sugarlabs.org wrote: Develop need a lot of love to make it easier to understand. Of course, newbie is a relative category :) You will understand more and more with time and dedication. Strongly agree. Is ok, keep the communication alive. For sure :) -- Kamaljeet Kaur kamalkaur188.wordpress.com I am not what I am compared to others, I am what I am compared to my yesterday. ___ Sugar-devel mailing list Sugar-devel@lists.sugarlabs.org http://lists.sugarlabs.org/listinfo/sugar-devel
[Sugar-devel] [Design] Develop activity
Hello Designers, I just ran the Develop activity the first time which opens multiple files. Something looked strange to me there about the tabs and their colors. As Gonzalo told me in IRC that we need to be consistent with the Browse activity regarding tabs and colors, I agree. But I had a bad user experience when I opened 2-3 files there, it took several seconds and several clicks to get to know which file was I viewing out of these 3. I mean, the tab which is open has a black color same as Browse activity( of tab name / file name) and those next to it are grey. As the other tabs remain grey and also the color behind an image in an image file is grey, looks grey as a whole making me feel that grey is highlighted and that grey file is opened. See here: http://202.164.53.122/~kamaljeet/sugar.png Here, it seems like the first file is open but actually it is the second one. So there is some problem with grabbing user's attention to the opened file. Although grey seems more eye catching and highlighted than black but IDK if it can be changed in Browse activity as well. IMO, either the opened file must be highlighted grey(I prefer this) or the color behind opened image should be changed or a third thing that we can do is changing the position of image(Text can be above and the image below). I just want you to look into the matter and take suitable action regarding good user experience. Thank you -- Kamaljeet Kaur kamalkaur188.wordpress.com ___ Sugar-devel mailing list Sugar-devel@lists.sugarlabs.org http://lists.sugarlabs.org/listinfo/sugar-devel
[Sugar-devel] Activity failed to start!
Hello developers Can you please help me know the right way to download/install activities in sugar? I downloaded Etoys and Develop 40 from http://activities.sugarlabs.org/en-US/sugar/ from browser activity. Both are shown in journal. But when opened, activity icon flashes and there is a message: Activity failed to start Stop [ ] ( with stop button. Even I couldn't find the logs in log activity. While trying to find it out, I reached here: http://wiki.laptop.org/go/Python_Standard_Logging_in_Sugar And from the above link, I tried 'sugar-launch activity-name' command. Which gave the output: kamal@kamal:~/sugar-build$ sugar-launch Etoys The program 'sugar-launch' can be found in the following packages: * sugar-tools-0.84 * sugar-tools-0.86 * sugar-tools-0.88 * sugar-tools-0.90 * sugar-tools-0.96 Try: sudo apt-get install selected package So I used apt-get to install Etoys. It has downloaded 44.3MBs data. But the same problem is there. What I'm doing wrong? -- Kamaljeet Kaur kamalkaur188.wordpress.com ___ Sugar-devel mailing list Sugar-devel@lists.sugarlabs.org http://lists.sugarlabs.org/listinfo/sugar-devel
[Sugar-devel] Need your views, ASAP.
Hello all members, I need help with the first question in You and Community section. As I'll be working for project Port to python 3, I need three answers, one of which will I get from the mentors and other from memberss So the members and mentors reading this message, Please give your answer regarding what will be the impact after completion of my project on community? I need to add this answer there and it should be of 1-3 paragraphs. There are four outlined steps: Step 1. Make use of GTK3 instead of GTK2 because sugar and the apps use it. Step 2. Port the Sugar core to python3. Step 3. Developing a robust test suite. Step 4: Port an existing sugar activity to python3 and document process Please tell me what are your views about the effect on community after completion of this project? Thank you -- Kamaljeet Kaur kamalkaur188.wordpress.com ___ Sugar-devel mailing list Sugar-devel@lists.sugarlabs.org http://lists.sugarlabs.org/listinfo/sugar-devel
[Sugar-devel] Introduction
Hello there, I'm Kamaljeet Kaur, a third year Computer Science student from Punjab, India. I have interest in learning Python, JavaScript, HTML and CSS. Have also used them in my previous open-source project. On the announcement of selected organisations in GSoC-14, I didn't know much about the organisations whose names I already knew. As from my childhood, I got attracted towards art and creative stuffs, the name Sugar-labs made me look inside. After exploring, I came to know about the Design team, writers team and all the creative people out there. I felt like, Wow! This community is for me. I can do it. Explored more and set up the development environment. And this is my first love that didn't make me feel like searching for any other organisation that interests me meaning that I like the first one only :D Well, now I want to continue my journey with this sweet community: Sugar-labs. Want to apply for Activity Unit Tests. What I have got about it from my own interpretation is that Activity Unit Tests mean something like testing output for other programs w.r.t. their Inputs. Can be like checking the accuracy and reliability. Correct me if I'm wrong. @Mentors Walter Bender and Daniel Narvaez Please guide me to explore and get more about this project. Or you'll suggest me to explore other projects too? Please guide me so that I can get the maximum about the project before applying which will help me to understand it better and ultimately complete it properly. Thank you. -- Kamaljeet Kaur kamalkaur188.wordpress.com ___ Sugar-devel mailing list Sugar-devel@lists.sugarlabs.org http://lists.sugarlabs.org/listinfo/sugar-devel
