Hello all! The first week of coding has begun on debian debsources
for Google Summer of Code. Read on for my first report.
The Project
-----------------
The project title is "Improving Accessibility and front-end of
Debsources" You'll find the Google Summer of Code information
[on their site][1]. For a more detailed project summary see the
[Debian Wiki Page][2].
We decided on using a [Trello board][3] to keep tabs on item progress.
We couldn't find something open source that worked well enough.
If anybody has any suggestions send them on.
Week 1 Report
-----------------------
### Tasks Complete
- Initial choices were made regarding libraries. Taking into account
Debian packaging, we chose [Twitter's Bootstrap][4],
contained in `libjs-bootstrap`
Most of these were talked about in the IRC as well as the tech thread
on the [qa-debsources list][5].
- The package's dependency was introduced and tested. This was
the first code for the project and we decided on using a
[Github fork][6].
[Related PR](
https://github.com/Debian/debsources/pull/61/)
The test also makes sure that other static componants that should
be available are there.
### Tasks in Progress
- Add CSS framework to main base layout files
Related branch: `feature-css-base` (no pushes yet)
This task encompasses changing the base template file
( found in `/debsources/app/templates/base.html`) to being responsive.
This task was larger than expected, as the navbar is actually
a subblock that's overwritten by other parts of the webapp.
Rather than converting each individual instance of the navigation
I need to write a macro, some programmatic visual component,
handle the responsive navigation.
There has been no commit made on this as it's still WIP.
- Make final choice on client rendering library
This task has been put in the burner as it's not as high priority as
the other task in progress, but none-the-less, research has been
going into it.
The primary areas of research involve digging around inside
debsources source code, to see how transferable the html rendering
aspects are.
Another issue with choosing this library is the debian packages
available.
A few very nice looking frameworks have no packages on debian.
The best example of this is [ReactJS][7]. It's a high
performance and lightweight visual _javascript_ model.
Data feels very easy to track using React and [Redux][8].
It appears that unless I want to create a Debian package for React,
the best option would be [AngularJS][9]. My main issue with angular
is its seems to look bloated.
More information about this task will be included in next weeks report.
### Issues
The primary issue facing me as a student this week was adjustment.
I had issues adjusting to the work schedule.
The reasons for this mainly revolve around my sleep schedule.
I missed the scheduled Tuesday morning meeting.
While these issues are negative I am working to improve.
Last night I slept at 8AM, which shows how extremely shifted my sleep
is. If I can't sleep tonight (it's already late as I'm writing this) I will visit
a doctor and see what medical checks I can put in place.
Apart from that my other issue was time management. I've switched to
using the pomodoro technique on Thursday and I've been much more
productive. I did take Saturday off however, which meant I didn't get to
finish the CSS framework issue.
Final Words
---------------------
Thanks for reading this far. The structure I deliver these reports is a
work in progress.
Feedback is greatly appreciated on all aspects of this report as well
as feedback regarding issues or tasks.
Thanks,
~devoxel
---
[1]:
https://summerofcode.withgoogle.com/projects/#4593198689157120 "GSoc"
[2]:
https://wiki.debian.org/SummerOfCode2016/StudentApplications/AaronDelaney[3]:
https://trello.com/b/TQEwttbV/debsources-gsoc-2016 "Trello Board"
[4]: http://
http://getbootstrap.com/ "Bootstrap 3"
[5]:
https://lists.alioth.debian.org/mailman/listinfo/qa-debsources/ "Mailling"
[6]:
https://github.com/devoxel/debsources "Github Fork"
[7]:
https://facebook.github.io/react/ "ReactJS (by Facebook)"
[8]:
http://redux.js.org/ "Redux State Container"
[9]:
https://angularjs.org/ "AngularJS"