Go Back   vb.org Archive > Community Central > Community Lounge
FAQ Community Calendar Today's Posts Search

Reply
 
Thread Tools Display Modes
  #41  
Old 12-03-2004, 04:29 PM
filburt1 filburt1 is offline
 
Join Date: Feb 2002
Location: Maryland, US
Posts: 6,144
Благодарил(а): 0 раз(а)
Поблагодарили: 0 раз(а) в 0 сообщениях
Default

ANYWAY , you would not believe how complex this installation script is compared to the standard script I used for all of my vB2 hacks (including vBMS 1 and all the late hacks here). The vast majority of the time trying to code it was trying to figure out how the hell vB's own functions work. Speaking independently from my moderator position, the documentation is terrible within the code. Not only do nearly all of the functions lack any documentation, but the ones that have it have incorrect function names and don't document any of their arguments or the return value. Even the variable names don't help much.

I would pay a significant extra for a developer edition of a vB license that included proper PHPDoc-formatted (similar to PHPDoc) comments for each function. It would have cut my development time for vBMS and for future projects in half.
Attached Images
File Type: png Untitled-1.png (316.8 KB, 0 views)
Reply With Quote
  #42  
Old 12-03-2004, 05:34 PM
Dean C's Avatar
Dean C Dean C is offline
 
Join Date: Jan 2002
Location: England
Posts: 9,071
Благодарил(а): 0 раз(а)
Поблагодарили: 0 раз(а) в 0 сообщениях
Default

Quote:
Originally Posted by filburt1
Speaking independently from my moderator position, the documentation is terrible within the code. Not only do nearly all of the functions lack any documentation, but the ones that have it have incorrect function names and don't document any of their arguments or the return value. Even the variable names don't help much.

I would pay a significant extra for a developer edition of a vB license that included proper PHPDoc-formatted (similar to PHPDoc) comments for each function. It would have cut my development time for vBMS and for future projects in half.
I couldn't agree more, the documentation within the code is terrible as it is.
Reply With Quote
  #43  
Old 12-03-2004, 06:02 PM
Brad Brad is offline
 
Join Date: Nov 2001
Posts: 4,765
Благодарил(а): 0 раз(а)
Поблагодарили: 0 раз(а) в 0 сообщениях
Default

Quote:
Originally Posted by Dean C
I couldn't agree more, the documentation within the code is terrible as it is.
I agree aswell, and would pay extra for said 'developer edition'
Reply With Quote
  #44  
Old 12-03-2004, 06:29 PM
Dean C's Avatar
Dean C Dean C is offline
 
Join Date: Jan 2002
Location: England
Posts: 9,071
Благодарил(а): 0 раз(а)
Поблагодарили: 0 раз(а) в 0 сообщениях
Default

Oh I wouldn't pay extra, it's just common sense and useful to document your code well
Reply With Quote
  #45  
Old 12-05-2004, 05:09 PM
Craigr's Avatar
Craigr Craigr is offline
 
Join Date: May 2002
Location: Ayr, Scotland
Posts: 194
Благодарил(а): 0 раз(а)
Поблагодарили: 0 раз(а) в 0 сообщениях
Default

Quote:
Originally Posted by filburt1
ANYWAY , you would not believe how complex this installation script is compared to the standard script I used for all of my vB2 hacks (including vBMS 1 and all the late hacks here). The vast majority of the time trying to code it was trying to figure out how the hell vB's own functions work. Speaking independently from my moderator position, the documentation is terrible within the code. Not only do nearly all of the functions lack any documentation, but the ones that have it have incorrect function names and don't document any of their arguments or the return value. Even the variable names don't help much.

I would pay a significant extra for a developer edition of a vB license that included proper PHPDoc-formatted (similar to PHPDoc) comments for each function. It would have cut my development time for vBMS and for future projects in half.
Codename Sunset looks good too. Have you started work on it?

Will you do a convertor from Photopost to Sunset?
Reply With Quote
  #46  
Old 12-05-2004, 07:37 PM
filburt1 filburt1 is offline
 
Join Date: Feb 2002
Location: Maryland, US
Posts: 6,144
Благодарил(а): 0 раз(а)
Поблагодарили: 0 раз(а) в 0 сообщениях
Default

Given I don't own a license for Photopost, that's not likely. I'm also spending the vast majority of my time finalizing vBMS rather than working on new projects.
Reply With Quote
  #47  
Old 12-07-2004, 01:11 AM
DrkFusion's Avatar
DrkFusion DrkFusion is offline
 
Join Date: Nov 2001
Posts: 1,926
Благодарил(а): 0 раз(а)
Поблагодарили: 0 раз(а) в 0 сообщениях
Default

I have just started the biggest of coding projects I will have ever done. Incorporates alot of modulizing, and has heavy reliance on security. Let's see what I have learned in the past few years will bring to me now in this big project.
Reply With Quote
  #48  
Old 12-08-2004, 08:13 PM
filburt1 filburt1 is offline
 
Join Date: Feb 2002
Location: Maryland, US
Posts: 6,144
Благодарил(а): 0 раз(а)
Поблагодарили: 0 раз(а) в 0 сообщениях
Default

To those who asked about Sunset, I updated its product page with a list of planned features, although please don't ask for a release date because it is far too early in the development to even guess.
Reply With Quote
Reply


Posting Rules
You may not post new threads
You may not post replies
You may not post attachments
You may not edit your posts

BB code is On
Smilies are On
[IMG] code is On
HTML code is Off

Forum Jump


All times are GMT. The time now is 11:47 PM.


Powered by vBulletin® Version 3.8.12 by vBS
Copyright ©2000 - 2025, vBulletin Solutions Inc.
X vBulletin 3.8.12 by vBS Debug Information
  • Page Generation 0.03980 seconds
  • Memory Usage 2,249KB
  • Queries Executed 14 (?)
More Information
Template Usage:
  • (1)SHOWTHREAD
  • (1)ad_footer_end
  • (1)ad_footer_start
  • (1)ad_header_end
  • (1)ad_header_logo
  • (1)ad_navbar_below
  • (1)ad_showthread_beforeqr
  • (1)ad_showthread_firstpost
  • (1)ad_showthread_firstpost_sig
  • (1)ad_showthread_firstpost_start
  • (3)bbcode_quote
  • (1)footer
  • (1)forumjump
  • (1)forumrules
  • (1)gobutton
  • (1)header
  • (1)headinclude
  • (1)navbar
  • (3)navbar_link
  • (120)option
  • (1)pagenav
  • (1)pagenav_curpage
  • (2)pagenav_pagelink
  • (8)post_thanks_box
  • (8)post_thanks_button
  • (1)post_thanks_javascript
  • (1)post_thanks_navbar_search
  • (8)post_thanks_postbit_info
  • (8)postbit
  • (1)postbit_attachment
  • (8)postbit_onlinestatus
  • (8)postbit_wrapper
  • (1)spacer_close
  • (1)spacer_open
  • (1)tagbit_wrapper 

Phrase Groups Available:
  • global
  • inlinemod
  • postbit
  • posting
  • reputationlevel
  • showthread
Included Files:
  • ./showthread.php
  • ./global.php
  • ./includes/init.php
  • ./includes/class_core.php
  • ./includes/config.php
  • ./includes/functions.php
  • ./includes/class_hook.php
  • ./includes/modsystem_functions.php
  • ./includes/functions_bigthree.php
  • ./includes/class_postbit.php
  • ./includes/class_bbcode.php
  • ./includes/functions_reputation.php
  • ./includes/functions_post_thanks.php 

Hooks Called:
  • init_startup
  • init_startup_session_setup_start
  • init_startup_session_setup_complete
  • cache_permissions
  • fetch_postinfo_query
  • fetch_postinfo
  • fetch_threadinfo_query
  • fetch_threadinfo
  • fetch_foruminfo
  • style_fetch
  • cache_templates
  • global_start
  • parse_templates
  • global_setup_complete
  • showthread_start
  • showthread_getinfo
  • forumjump
  • showthread_post_start
  • showthread_query_postids
  • showthread_query
  • bbcode_fetch_tags
  • bbcode_create
  • showthread_postbit_create
  • postbit_factory
  • postbit_display_start
  • post_thanks_function_post_thanks_off_start
  • post_thanks_function_post_thanks_off_end
  • post_thanks_function_fetch_thanks_start
  • post_thanks_function_fetch_thanks_end
  • post_thanks_function_thanked_already_start
  • post_thanks_function_thanked_already_end
  • fetch_musername
  • postbit_imicons
  • bbcode_parse_start
  • bbcode_parse_complete_precache
  • bbcode_parse_complete
  • postbit_attachment
  • postbit_display_complete
  • post_thanks_function_can_thank_this_post_start
  • pagenav_page
  • pagenav_complete
  • tag_fetchbit_complete
  • forumrules
  • navbits
  • navbits_complete
  • showthread_complete