search

sugarlabs / sugar-docs

Documentation for Contributors and Developers
86 stars 104 forks source link

Port to GTK+ 3 Guide #149

Closed quozl closed 6 years ago

quozl commented 6 years ago

Migrate from Wiki. https://wiki.sugarlabs.org/go/Features/GTK3/Porting

rdrsadhu commented 6 years ago

The script I've been developing for migrating the Activities wiki-pages shall help?

Let me know,

quozl commented 6 years ago

Also needs updating, for which experience with porting from GTK+ 2 to GTK+ 3 will be critical.

rhl-bthr commented 6 years ago

I am updating the guide in the wiki itself, which can be migrated after that

yell0wfl4sh commented 6 years ago

@Pro-Panda can we coordinate on this?

rhl-bthr commented 6 years ago

@yashagrawal3, I have almost completed updating the guide, and will complete it in ~4 hours. It can then be migrated to sugar-docs

yell0wfl4sh commented 6 years ago

@Pro-Panda great! I will look if I can add anything. Thanks!

rhl-bthr commented 6 years ago

@rdrsadhu, in my opinion, the pages can now be migrated

which exact pages to migrate

  1. https://wiki.sugarlabs.org/go/Features/GTK3/Porting
  2. And the following examples (They are present as links in the bottom of the page):

My suggestion would be to make an examples directory and place the examples there, while also updating the links in the main page

rdrsadhu commented 6 years ago

150

Please review.

quozl commented 6 years ago

https://github.com/sugarlabs/sugar-docs/pull/150 did improve, but did not fully fix this issue.

Examples are yet to be moved.

rhl-bthr commented 6 years ago

We removed the individual examples after observing that they don't contain anything useful to add to the main page [Ref]. Should they be incorporated in a different manner ?

quozl commented 6 years ago

Okay, thanks. Discussion split between issue and pull request was a cause of my misunderstanding.

tony37 commented 6 years ago

This link shows nothing of what was done. How is this version a better documentation of the conversion process than the original?

Ideally, the Wiki speaks to our users and potential users. The gitHub speaks to developers. Perhaps this move is appropriate because the existing pages describe how to do the conversion, a task for developers. However, where is the page that explains to our users how they benefit from this conversion? For example, users need to know how recent a build they need to install in order to use gtk+3. We still have many XO users with Sugar 0.82.

Tony

On Saturday, 07 April, 2018 11:49 AM, Rudra Sadhu wrote:

150 https://github.com/sugarlabs/sugar-docs/pull/150

Please review.

— You are receiving this because you are subscribed to this thread. Reply to this email directly, view it on GitHub https://github.com/sugarlabs/sugar-docs/issues/149#issuecomment-379429762, or mute the thread https://github.com/notifications/unsubscribe-auth/AAULknROoq0ViR9zFXiZKW2WyMlHM_VUks5tmDdigaJpZM4TGOk1.

quozl commented 6 years ago

Our GTK+ 3 Porting Guide is for developers and has been moved from the Wiki so that it can be maintained by developers. Users should contact their integrator or build supplier. Anyone still using Sugar 0.82 should avoid installing any recently developed activities, as they won't work.