The user's development process documentation?

In this forum we discuss the future of Ren'Py, both bug fixes and longer-term development. Pre-releases are announced and discussed here.
Post Reply
Message
Author
User avatar
Bill_Ames
Newbie
Posts: 20
Joined: Sat Apr 13, 2019 2:00 pm
Contact:

The user's development process documentation?

#1 Post by Bill_Ames » Mon Apr 15, 2019 10:27 am

Hi. I am a retired Senior SQA Engineer and recently discovered VNs and Ren'Py. I am very aware of how important it is to have good relations with my developers and to provide them useful and accurate feedback. One of the things I look for, and never find, is good, no, excellent user documentation. So, is there, where is there, a document supporting the user process for developing a VN. Something that is a checklist and will have things in the proper order. Too often people try to do something that needs input from something they needed to do first but di not know that, they had not learned the "sequence" of the process. Some document defining this process is desired.

I had asked and was told that this place was most appropriate to use for providing feedback (not bugs) on anything I may encounter. I will use it for this unless there is a better place.

Is there a place to view an open bug list? As a QA I knew that it was necessary to see if something observed was not already logged. I also know that often what a user sees is often just a symptom of a bug and that a bug can have different symptoms. Bug list?

I also know that there are things that can not be "fixed" or changed. Often marked, hopefully as, Next Version? :)

Please let me know if I step on anyone's toes, I am a very opinionated senior citizen and will speak my mind.
Bill Ames -
Permutations of issues and discerning detail with skill

User avatar
trooper6
Lemma-Class Veteran
Posts: 3712
Joined: Sat Jul 09, 2011 10:33 pm
Projects: A Close Shave
Location: Medford, MA
Contact:

Re: The user's development process documentation?

#2 Post by trooper6 » Wed Apr 17, 2019 1:45 am

For lists of bugs/issues, you can go to the GitHub: https://github.com/renpy/renpy
A Close Shave:
*Last Thing Done (Aug 17): Finished coding emotions and camera for 4/10 main labels.
*Currently Doing: Coding of emotions and camera for the labels--On 5/10
*First Next thing to do: Code in all CG and special animation stuff
*Next Next thing to do: Set up film animation
*Other Thing to Do: Do SFX and Score (maybe think about eye blinks?)
Check out My Clock Cookbook Recipe: http://lemmasoft.renai.us/forums/viewto ... 51&t=21978

User avatar
Imperf3kt
Lemma-Class Veteran
Posts: 3040
Joined: Mon Dec 14, 2015 5:05 am
Location: Your monitor
Contact:

Re: The user's development process documentation?

#3 Post by Imperf3kt » Wed Apr 17, 2019 1:58 am

Regarding a user documentation, renpy itself includes a tutorial which sets out certain things in an approximate order for which someone can learn in.
There is also the quick start guide.

Ultimately, however, it is too dependant on what a user might be wanting to implement in their VN, so a set path to learning renpy doesn't really suit everybody.

The general consensus, as I understand it, is
- learn about labels and label control / dialogue flow

- learn about showing images and playing audio or video

- learn how to use variables and simple python statements to control branching dialogue

- learn renpy screen language to customise the look of your game and begin adding advanced features. This might also include Renpy ATL

- learn python further in order to start going beyond just renpy screen language
Warning: May contain trace amounts of gratuitous plot.
pro·gram·mer (noun) An organism capable of converting caffeine into code.

Twitter
Imperf3kt Blackjack - a WIP blackjack game for Android made using Ren'Py
Free Android GUI - Updated occasionally

User avatar
Bill_Ames
Newbie
Posts: 20
Joined: Sat Apr 13, 2019 2:00 pm
Contact:

Re: The user's development process documentation?

#4 Post by Bill_Ames » Wed Apr 17, 2019 4:29 am

Opinion, if I may. Good programming techniques should not be constrained by the lack of skill or actual results desired. How are you supporting writing good code and properly documenting (in the code) what is being done?

More opinion, do you have a good selection of well-documented code templates that new users can use to accomplish the more obvious tasks they will need to perform? When I was learning the Wintask language I had access to examples they provided. Unfortunately, they were often very poorly presented, not written for a newbie. Good examples are so important. Got any?

Are there any youtube videos showing how some of the things on your list should be done? If I were not so old and busy I would make some myself but I only ask (suggest) because I know how valuable they can be.

Thank you for your time and insight.
Bill Ames -
Permutations of issues and discerning detail with skill

User avatar
Bill_Ames
Newbie
Posts: 20
Joined: Sat Apr 13, 2019 2:00 pm
Contact:

Re: The user's development process documentation?

#5 Post by Bill_Ames » Wed Apr 17, 2019 4:32 am

trooper6 wrote:
Wed Apr 17, 2019 1:45 am
For lists of bugs/issues, you can go to the GitHub: https://github.com/renpy/renpy
Wonderful. Thank you. Is there a bug report form?
Bill Ames -
Permutations of issues and discerning detail with skill

User avatar
Imperf3kt
Lemma-Class Veteran
Posts: 3040
Joined: Mon Dec 14, 2015 5:05 am
Location: Your monitor
Contact:

Re: The user's development process documentation?

#6 Post by Imperf3kt » Wed Apr 17, 2019 4:49 am

Example scripts and code are included with Ren'Py in the form of the tutorial and the demo / sample game "The Question", both of which anyone can look at the scripts for and analyse them. The Tutorial explains the given codes in depth and how they should be used.

Ren'Py itself is highly accessible through the /common folder. All files are well commented, but probably not particularly suited to a newbie.

Example code made by users can be found in the "cookbook" section of the forum. Quality, comments and up-to-date practices vary since after all, they are posted by the community which is made up of individuals of varying skill levels.

YouTube has a plethora of information uploaded by many individuals however, I wish it didn't as most of it is outdated or not a the proper/preferred way to do things, resulting in many confused newbies coming here with questions of why certain things from tutorial x don't work or cause bugs.

There was a wiki, still accessible, but legacy and only kept for archival reasons (plus we begged). It isn't recommended to use most of the content within it in modern Ren'Py versions (since about 6.7)
Warning: May contain trace amounts of gratuitous plot.
pro·gram·mer (noun) An organism capable of converting caffeine into code.

Twitter
Imperf3kt Blackjack - a WIP blackjack game for Android made using Ren'Py
Free Android GUI - Updated occasionally

Post Reply

Who is online

Users browsing this forum: No registered users