Eric 3:37 pm on April 25, 2013
Tags: GSOC ( 27 ), webOS

Sayak a GSoC candidate has been looking at…

Sayak (a GSoC candidate) has been looking at the webOS app and taking notes on how to port it, and just generally how it works. This could potentially be used as a part of the mobile handbook. Starting a thread here that we can comment and give feedback on Sayak’s notes. Sayak can you add a comment with a link to your notes?

#gsoc, #webos

Sayak Sarkar 3:52 pm on April 25, 2013

Here’s the link to first plain-text draft of the guide:-

https://www.dropbox.com/home/Public/A%20Guide%20to%20WordPress%20for%20WebOS
Sayak Sarkar 4:39 pm on April 25, 2013

Please find the directory consisting of the plain text files for the first draft of the WordPress for WebOS app here:-
https://drive.google.com/folderview?id=0BzFzGtkABcNJcFJta09QUzYyVVk&usp=sharing
- Eric 3:00 pm on April 26, 2013
  
  Hi Sayak,
  
  I took some time to read through the guide so far. Nice work! 🙂 Here are a few thoughts:
  
  Intro: I think there is a little word-smithing that could really nail the opening tone. For example: you might consider avoiding strong phrases like “practically abandoned”. Also, if the goal of the guide is to help folks create new apps based off of the webOS codebase the intro should probably focus on that goal a bit more. Right now it seems weighted a little too much toward the history of the project.
  
  Getting Started: I think this does a great job explaining how to get the existing codebase up and running in a browser. 🙂
  
  Sections 3 and 4: I think the level of detail here is very nice. It provides a great map for someone unfamiliar with the project and webOS apps. Looks like Section 4 is still a work in progress?
  
  What else do you have planned?
  
  @beaucollins Do you think you might have some time to look over these as well?
  - Sayak Sarkar 10:44 pm on April 26, 2013
    
    Hi Eric,
    
    Thanks for going through the guide and for your valuable feedback. I’ll try to improve the document based upon this.
    
    I agree about the intro. Even I somehow had a bit of reservation about that part. Will improve this section. Also, when I started with the write up I wasn’t quite sure what would be the perfect introduction, hence the emphasis on the history. I will try and modify it to put more weight on the porting part.
    
    Also, you are correct about section 4 being a work in progress. At this point I’m a bit confused about how to make the transition from the Architecture to the actual part on where to focus for porting the application to other platforms.
    
    Currently I’m planning to do some more research about the architechtural similarities and differences of a web-app based upon WebOS and that of one built upon Firefox OS. Based on these I plan to arrive upon a conclusion on how best to go about the transition. This would help me in writing my GSoC application as well as extending the documentation. Once I’ve my application ready, it should be easier to follow the points and append to the guide.
    
    From what I can see at the moment, writing this guide is a gonna be a pretty long term affair. The reason behind this is, we can only write about the Porting mechanism once we have tried and tested it out on atleast one platform transition to maintain a good quality of documentation. This means that I would need to carry on with this documentation process during the actual coding period and write my observations as facts rather than a strong guesswork.
    
    Regards,
    Sayak
  - Sayak Sarkar 9:24 pm on April 27, 2013
    
    Hey Eric,
    
    I have just updated the Introduction as per your suggestions. Please do let me know if further modifications are required once you go thrugh it.
    
    Regards,
    Sayak
    - Eric 2:37 pm on April 29, 2013
      
      Crafting a good intro can be tough. Its much nicer now. 🙂