AutoHotkey Community

It is currently May 27th, 2012, 4:31 am

All times are UTC [ DST ]




Post new topic Reply to topic  [ 35 posts ]  Go to page Previous  1, 2, 3
Author Message
 Post subject:
PostPosted: March 2nd, 2010, 12:12 am 
Offline

Joined: November 7th, 2006, 9:47 pm
Posts: 1934
Location: Germany
What do you mean tank? Why is the COM special in this case? Automatic downloading requires that the developer provides all needed information in a standardized manner also.

_________________
{1:"ahkstdlib", 2:"my libs", 3:"my apps", 4:"my license"}
--> Don't feed the troll! <--


Report this post
Top
 Profile  
Reply with quote  
 Post subject:
PostPosted: March 2nd, 2010, 1:12 am 
Offline
User avatar

Joined: December 21st, 2007, 3:14 pm
Posts: 3826
Location: Louisville KY USA
Sean makes updates and in this case has been successfull getting all references to point at his official download. this may have changed with COMAHK or ahk L and U

I bring it up because of limited current and possible version updates in the future

_________________
No matter what your oppinion Please join this discussion
Formal request to Polyethene
Image


Report this post
Top
 Profile  
Reply with quote  
 Post subject:
PostPosted: March 17th, 2010, 11:14 pm 
Offline

Joined: February 14th, 2008, 10:07 pm
Posts: 72
Location: Santa Clara, CA
I've been using AHK for a couple of years now and wrote and maintain Serial ( COM ) Port Console Script http://www.autohotkey.com/forum/viewtopic.php?t=28703&highlight=serial.

I believe that there needs to be some level of oversight and enforcement of minimum standards in stdlib for the project to be successful. Otherwise the stdlib will end up being a mess just like the functions section of the website. For instance, I think that my Serial COM Port functions should be included, however, as they stand now should not be accepted because (as was recently pointed out to me) they are not stdlib compatible.

Here are my thoughts on how to better organize the functions and begin a stdlib.

Definitions
Function - code that is intended to be included in another script.
Product – standalone script.

*There should be one webpage for productized Functions and one web page for productized Products.

*There should be perhaps one or two moderators for each page. The moderators will decide which Functions/Products get included in their respective productized Function/Products web page.

*Each Function/Product will get it's own entry and the thread will be locked to everyone (except the author/maintainer).

*These pages should include everything necessary for the end user to successfully apply the Function/Product (a link to discussion forum, documentation, source code, example code using the Function, description of how the Function/Product was tested, change logs).

*There should not be any discussions on the Function/Product pages. Discussion can be done in the Scripts & Functions section of the forum.

*Individuals can submit their Function/Product to the moderators for inclusion into the respective web page.

*The Function/Product should NOT be accepted unless the following criteria is met:

........-The Function/Product provides a solution for a non-trivial problem and will provide significant value to AHK. Otherwise it should just stay in the Scripts & Functions forum.

........-The submitter has provided the link to the discussion forum, documentation, source code, example code using the Function, description of how the Function/Product was tested.

........-The source code meets certain guidelines (readability, error checking, best practices, …)

........-The submitter accepts the responsibility of maintaining the Function/Product.

This way there will be a list of high value Functions/Products on the website that won't get lost in the haystack and can be easily implemented by the end user.

But of course there should be a zip file which includes all accepted Functions/Products and Tuncay's utility would be a very nice front end for the zip file.

Well, what ever the decision. I'd be willing to help wherever possible.


Report this post
Top
 Profile  
Reply with quote  
 Post subject:
PostPosted: March 17th, 2010, 11:19 pm 
I agree with some of that, except is should not be the moderators final call, if a moderator "don't like you" you'd never get accepted...I don't think it should be dictatorship "you're allowed in", "you're not, get lost"...something less formal...or able to bypass a mean moderator...


Report this post
Top
  
Reply with quote  
 Post subject:
PostPosted: March 18th, 2010, 7:48 pm 
Offline

Joined: February 14th, 2008, 10:07 pm
Posts: 72
Location: Santa Clara, CA
I suppose a rogue moderator could be a problem, however, this was the best way that I could think of maintaining some level of quality control. Hopefully these kinds of problems would be minimal. Your idea of having a way to bypass a moderator is good.

My main concern is that we don't let the stdlib end up like the functions & scripts section - thousands of mostly undocumented and unsupported functions. If the stdlib ends up like this then it will be essentially useless.

After I made the last post I was thinking more about documentation. The level of documentation of AHK is superb. I think the stdlib should try to maintain this excellent level of documentation. Perhaps the best way to accomplish this is to provide a link in the Functions/Products section to a wiki page. This way everyone in the community will be able to contribute to the documentation effort.

Like i said before, I'b willing to help in any way possible.


Report this post
Top
 Profile  
Reply with quote  
Display posts from previous:  Sort by  
Post new topic Reply to topic  [ 35 posts ]  Go to page Previous  1, 2, 3

All times are UTC [ DST ]


Who is online

Users browsing this forum: dmatch and 2 guests


You can post new topics in this forum
You can reply to topics in this forum
You cannot edit your posts in this forum
You cannot delete your posts in this forum
You cannot post attachments in this forum

Search for:
Powered by phpBB® Forum Software © phpBB Group