Outreachy Mid-Term

Installing Wattsi on Ubuntu 14.04

This week i installed Wattsi. “Wattsi” is a build tool for creating the HTML Standard from its source. It works in concert with other scripts.

I am adding the steps of how to install it locally, and how to cope if any of the following errors occurs mentioned below:

Follow the Readme of Wattsi:

https://github.com/whatwg/wattsi/blob/master/README.md

Mainly the errors occur due to incompatible version of fpc with wattsi:

1. Ubuntu comes with the pre-installed package of Free Pascal Compiler. Firstly check the version by typing fpc in terminal. Please make sure the version is compatible with the Wattsi’s required version which is currently 3.0.0 .

2. otherwise first remove the Pre-installed package by:
sudo apt-get remove fpc*
and then install a new by choosing the appropriate operating system from: http://www.freepascal.org/download.var

3. After downloading the package,
when the .tar file is downloaded, first untar the file, in some directory where you have write permission, using the following command:

tar -xvf fpc.tar

To install Free Pascal, all that needs to be done now is give the following command:
./install.sh

Some other important links:

4. After adding wattsi to the same root directory as the html-build and whatwg/html,
Follow these steps:
1)  cd wattsi/
2) ./build.sh

If for some reason you need to build a wattsi binary with 64-bit code, you can do so by adding -Px86_64 to the DEFINES line in the src/build.sh file, so that it looks like this:

DEFINES=”-dUSEROPES -dLINES -dPARSEERROR -Px86_64″

5. html-build script uses wattsi from a remote server, but if you have a slow internet connection, it might take a very long time to parse or break in between. So for me it was better to install locally.

Project’s Progress this week:

Here are the PR’s i filed and are successfully merged:
1. https://github.com/whatwg/html/pull/484
2. https://github.com/whatwg/html/pull/485
3. https://github.com/whatwg/html/pull/499
4. https://github.com/whatwg/html/pull/556

It’s been halfway now. Internship has made me learned alot and will do so with every issue i do.

Thanks for reading
Bestest
Richa

Outreachy week 4 and 5

Hello everyone,

In these two weeks i have managed to finish 5 issues of whatwg. I would like to tell more about the issues i worked on this week:

1. The First issue #331 is related to deprecation and as it was my first bug related to removal of a section from the whatwg spec. If considered as a bug for a new one it made me learnt a lot about the spec. There were loads of other sections related to it and for removing it every bit has to considered correctly.

2.  The Other two Bugs:

  1.   #485
  2.   #462
    made me learn how to write a short and to the point spec document plus some wrapping up the document!.

#456 – Thanks to Simon Peters for the reviews 🙂

4.  The next PR is in review right now – #499

The last thing i would like to mention about the Thursday meeting with my mentor(annevk).
After some more discussions with other contributors for further work on https://developers.whatwg.org/ , i will be starting on the whatwg’s another project. I have currently set my goals to complete 5 more issues in the next two weeks and setup Wattsi on my machine. Wattsi is the build tool of Whatwg spec.

Thanks for giving time to read my work, i’ll be updating more here.
Have a nice day

Outreachy week 2 and 3

HAPPY 2K16 All of you 

Here is now the successful end of two more weeks. Whatwg spec documentation is very diverse and big and to get it thoroughly is a very big thing, i think. But this week has been a achievement for me as i have been getting most of the points how i have to work on the spec and it’s issues. This week i also kept an eye over my writing skills too, as just solving the bug is not enough, presenting the PR and making it easy to understand for others is also very important. Thanks to Domenic Denicola(Domenic)

In the 2nd Week, i mostly first sorted out which bugs i have to work on and here is the To-Do List for this week:

  1. https://github.com/whatwg/html/issues/388
  2. https://github.com/whatwg/html/issues/115
  3. https://github.com/whatwg/html/issues/331
  4. https://github.com/whatwg/html/issues/345

 

The Bugs i have successfully worked upon till now are:

  1. https://github.com/whatwg/html/pull/418
  2. https://github.com/whatwg/html/pull/449
  3. https://github.com/whatwg/html/pull/456

 

We (my mentor annevk and me) do a status meeting every Thursday. Every meeting is very helpful to create a clear picture of what needs to be done and we find solutions to road blocks I face.

Summarizing some points about the things i got to learn from the meetups:

  1. First of all seeing such a big spec document, i got worried to reach upto my goals. But annevk suggested to just reach on those bugs first i could work easily on and then gradually learning about it, i’ll be more confident solving them.
  2. Hence i followed his advice and here now i have solved 3 bugs 🙂
  3. First and second week was mostly spent in gradually pacing up for the project, but now everything is sorted according to the difficulty and understanding levels. And i will be following my above To-Do list of issues for this week.

Thanks for reading through my two week journey, i’ll be updating my further work and achievements here. Stay Tuned!

Cheers