Re: [Elementary-dev-community] Better HIG layout
I don't think we want any code in the HIG. As I said earlier, it's a set of guidelines for design, not developer documentation for implementation. Code would be great in the developer guide which we're working on. :) On Apr 7, 2013 9:42 AM, "Nishant Agrwal" wrote: > Should the example code be in the HIG or the granite doocuentation? Maybe > we could link to the API reference for our own wigdets, and demonstrate > techniques like padding and background tasks in the HIG itself? > > On Sun, Apr 7, 2013 at 6:03 PM, Sergey Shnatsel Davidoff < > [email protected]> wrote: > > Hey guys, > > Our HIG feels a little abstract right now. It communicates the ideals but > gives little idea about how to implement the recommendations. > > I thought it would be cool to include example code that implements the > recommendations in Vala/GTK/Granite. For example it's hard for me to get > all the padding right in > http://elementaryos.org/docs/human-interface-guidelines/ui-toolkit-elements/windows/dialogsor > implement proper handling of background tasks (btw, are we updating the > relevant HIG article or not?). A side-by-side layout where you can see the > recommendations AND example code that implements them would be great IMO. > > Thoughts? > > -- > Sergey "Shnatsel" Davidoff > OS architect @ elementary > > > -- > Mailing list: https://launchpad.net/~elementary-dev-community > Post to : [email protected] > Unsubscribe : https://launchpad.net/~elementary-dev-community > More help : https://help.launchpad.net/ListHelp > > -- Mailing list: https://launchpad.net/~elementary-dev-community Post to : [email protected] Unsubscribe : https://launchpad.net/~elementary-dev-community More help : https://help.launchpad.net/ListHelp
Re: [Elementary-dev-community] Better HIG layout
"A new HIG" doesn't really mean anything; we're constantly tweaking and revising but a rewrite wouldn't make sense. > It communicates the ideals but gives little idea about how to implement the recommendations. This is accurate; it's a set of interface guidelines, not implementation documentation. Its purpose is to instill the design and serve as reference for the design. The implementation is separate. That said, we try to link between the HIG and docs when it's beneficial. I'll make a point of poking through and linking to the developer guide and vice versa where it makes sense. On Apr 7, 2013 9:49 AM, "Chris Timberlake" wrote: > elementary Studio is setup to accept a wide array of templates. It would > be no issue including them. When the sample code is made I can create the > templates and include them. ATM elementary Studio is looking at a public > June release; will a new HIG be done by then? > > Also it may be beneficial to get some sample code in the granite valadoc. > > - elementary Studio creator. > On Apr 7, 2013 6:33 AM, "Alfredo Hernández" > wrote: > >> That would be perfect, also, in some way those templates could be somehow >> implemented in Tom Beckmann's elementary Studio. >> >> As you state, sometimes it can be difficult to interpret coding >> guidelines without a tangible example. >> >> +1 >> On 7 Apr 2013 14:33, "Sergey "Shnatsel" Davidoff" < >> [email protected]> wrote: >> >>> Hey guys, >>> >>> Our HIG feels a little abstract right now. It communicates the ideals >>> but gives little idea about how to implement the recommendations. >>> >>> I thought it would be cool to include example code that implements the >>> recommendations in Vala/GTK/Granite. For example it's hard for me to get >>> all the padding right in >>> http://elementaryos.org/docs/human-interface-guidelines/ui-toolkit-elements/windows/dialogsor >>> implement proper handling of background tasks (btw, are we updating the >>> relevant HIG article or not?). A side-by-side layout where you can see the >>> recommendations AND example code that implements them would be great IMO. >>> >>> Thoughts? >>> >>> -- >>> Sergey "Shnatsel" Davidoff >>> OS architect @ elementary >>> >>> -- >>> Mailing list: https://launchpad.net/~elementary-dev-community >>> Post to : [email protected] >>> Unsubscribe : https://launchpad.net/~elementary-dev-community >>> More help : https://help.launchpad.net/ListHelp >>> >>> >> -- >> Mailing list: https://launchpad.net/~elementary-dev-community >> Post to : [email protected] >> Unsubscribe : https://launchpad.net/~elementary-dev-community >> More help : https://help.launchpad.net/ListHelp >> >> > -- > Mailing list: https://launchpad.net/~elementary-dev-community > Post to : [email protected] > Unsubscribe : https://launchpad.net/~elementary-dev-community > More help : https://help.launchpad.net/ListHelp > > -- Mailing list: https://launchpad.net/~elementary-dev-community Post to : [email protected] Unsubscribe : https://launchpad.net/~elementary-dev-community More help : https://help.launchpad.net/ListHelp
Re: [Elementary-dev-community] Better HIG layout
By the way, Chris, sorry for confusing you with Tom. Regards. On 7 Apr 2013 16:49, "Chris Timberlake" wrote: > elementary Studio is setup to accept a wide array of templates. It would > be no issue including them. When the sample code is made I can create the > templates and include them. ATM elementary Studio is looking at a public > June release; will a new HIG be done by then? > > Also it may be beneficial to get some sample code in the granite valadoc. > > - elementary Studio creator. > On Apr 7, 2013 6:33 AM, "Alfredo Hernández" > wrote: > >> That would be perfect, also, in some way those templates could be somehow >> implemented in Tom Beckmann's elementary Studio. >> >> As you state, sometimes it can be difficult to interpret coding >> guidelines without a tangible example. >> >> +1 >> On 7 Apr 2013 14:33, "Sergey "Shnatsel" Davidoff" < >> [email protected]> wrote: >> >>> Hey guys, >>> >>> Our HIG feels a little abstract right now. It communicates the ideals >>> but gives little idea about how to implement the recommendations. >>> >>> I thought it would be cool to include example code that implements the >>> recommendations in Vala/GTK/Granite. For example it's hard for me to get >>> all the padding right in >>> http://elementaryos.org/docs/human-interface-guidelines/ui-toolkit-elements/windows/dialogsor >>> implement proper handling of background tasks (btw, are we updating the >>> relevant HIG article or not?). A side-by-side layout where you can see the >>> recommendations AND example code that implements them would be great IMO. >>> >>> Thoughts? >>> >>> -- >>> Sergey "Shnatsel" Davidoff >>> OS architect @ elementary >>> >>> -- >>> Mailing list: https://launchpad.net/~elementary-dev-community >>> Post to : [email protected] >>> Unsubscribe : https://launchpad.net/~elementary-dev-community >>> More help : https://help.launchpad.net/ListHelp >>> >>> >> -- >> Mailing list: https://launchpad.net/~elementary-dev-community >> Post to : [email protected] >> Unsubscribe : https://launchpad.net/~elementary-dev-community >> More help : https://help.launchpad.net/ListHelp >> >> -- Mailing list: https://launchpad.net/~elementary-dev-community Post to : [email protected] Unsubscribe : https://launchpad.net/~elementary-dev-community More help : https://help.launchpad.net/ListHelp
Re: [Elementary-dev-community] Better HIG layout
elementary Studio is setup to accept a wide array of templates. It would be no issue including them. When the sample code is made I can create the templates and include them. ATM elementary Studio is looking at a public June release; will a new HIG be done by then? Also it may be beneficial to get some sample code in the granite valadoc. - elementary Studio creator. On Apr 7, 2013 6:33 AM, "Alfredo Hernández" wrote: > That would be perfect, also, in some way those templates could be somehow > implemented in Tom Beckmann's elementary Studio. > > As you state, sometimes it can be difficult to interpret coding guidelines > without a tangible example. > > +1 > On 7 Apr 2013 14:33, "Sergey "Shnatsel" Davidoff" > wrote: > >> Hey guys, >> >> Our HIG feels a little abstract right now. It communicates the ideals but >> gives little idea about how to implement the recommendations. >> >> I thought it would be cool to include example code that implements the >> recommendations in Vala/GTK/Granite. For example it's hard for me to get >> all the padding right in >> http://elementaryos.org/docs/human-interface-guidelines/ui-toolkit-elements/windows/dialogsor >> implement proper handling of background tasks (btw, are we updating the >> relevant HIG article or not?). A side-by-side layout where you can see the >> recommendations AND example code that implements them would be great IMO. >> >> Thoughts? >> >> -- >> Sergey "Shnatsel" Davidoff >> OS architect @ elementary >> >> -- >> Mailing list: https://launchpad.net/~elementary-dev-community >> Post to : [email protected] >> Unsubscribe : https://launchpad.net/~elementary-dev-community >> More help : https://help.launchpad.net/ListHelp >> >> > -- > Mailing list: https://launchpad.net/~elementary-dev-community > Post to : [email protected] > Unsubscribe : https://launchpad.net/~elementary-dev-community > More help : https://help.launchpad.net/ListHelp > > -- Mailing list: https://launchpad.net/~elementary-dev-community Post to : [email protected] Unsubscribe : https://launchpad.net/~elementary-dev-community More help : https://help.launchpad.net/ListHelp
Re: [Elementary-dev-community] Better HIG layout
Should the example code be in the HIG or the granite doocuentation? Maybe we could link to the API reference for our own wigdets, and demonstrate techniques like padding and background tasks in the HIG itself? On Sun, Apr 7, 2013 at 6:03 PM, Sergey Shnatsel Davidoff wrote: Hey guys, Our HIG feels a little abstract right now. It communicates the ideals but gives little idea about how to implement the recommendations. I thought it would be cool to include example code that implements the recommendations in Vala/GTK/Granite. For example it's hard for me to get all the padding right in http://elementaryos.org/docs/human-interface-guidelines/ui-toolkit-elements/windows/dialogs or implement proper handling of background tasks (btw, are we updating the relevant HIG article or not?). A side-by-side layout where you can see the recommendations AND example code that implements them would be great IMO. Thoughts? -- Sergey "Shnatsel" Davidoff OS architect @ elementary -- Mailing list: https://launchpad.net/~elementary-dev-community Post to : [email protected] Unsubscribe : https://launchpad.net/~elementary-dev-community More help : https://help.launchpad.net/ListHelp
Re: [Elementary-dev-community] Better HIG layout
That would be perfect, also, in some way those templates could be somehow implemented in Tom Beckmann's elementary Studio. As you state, sometimes it can be difficult to interpret coding guidelines without a tangible example. +1 On 7 Apr 2013 14:33, "Sergey "Shnatsel" Davidoff" wrote: > Hey guys, > > Our HIG feels a little abstract right now. It communicates the ideals but > gives little idea about how to implement the recommendations. > > I thought it would be cool to include example code that implements the > recommendations in Vala/GTK/Granite. For example it's hard for me to get > all the padding right in > http://elementaryos.org/docs/human-interface-guidelines/ui-toolkit-elements/windows/dialogsor > implement proper handling of background tasks (btw, are we updating the > relevant HIG article or not?). A side-by-side layout where you can see the > recommendations AND example code that implements them would be great IMO. > > Thoughts? > > -- > Sergey "Shnatsel" Davidoff > OS architect @ elementary > > -- > Mailing list: https://launchpad.net/~elementary-dev-community > Post to : [email protected] > Unsubscribe : https://launchpad.net/~elementary-dev-community > More help : https://help.launchpad.net/ListHelp > > -- Mailing list: https://launchpad.net/~elementary-dev-community Post to : [email protected] Unsubscribe : https://launchpad.net/~elementary-dev-community More help : https://help.launchpad.net/ListHelp
[Elementary-dev-community] Better HIG layout
Hey guys, Our HIG feels a little abstract right now. It communicates the ideals but gives little idea about how to implement the recommendations. I thought it would be cool to include example code that implements the recommendations in Vala/GTK/Granite. For example it's hard for me to get all the padding right in http://elementaryos.org/docs/human-interface-guidelines/ui-toolkit-elements/windows/dialogsor implement proper handling of background tasks (btw, are we updating the relevant HIG article or not?). A side-by-side layout where you can see the recommendations AND example code that implements them would be great IMO. Thoughts? -- Sergey "Shnatsel" Davidoff OS architect @ elementary -- Mailing list: https://launchpad.net/~elementary-dev-community Post to : [email protected] Unsubscribe : https://launchpad.net/~elementary-dev-community More help : https://help.launchpad.net/ListHelp
