Difference between revisions of "Community Changelogs-Contribution"

From ReactOS Wiki
Jump to: navigation, search
m
 
Line 15: Line 15:
 
* '''Drivers:''' All drivers go here. Device, class or filesystem drivers; no matter.
 
* '''Drivers:''' All drivers go here. Device, class or filesystem drivers; no matter.
  
* '''Shell:''' ReactOS Explorer and Command Prompt. '''No shell DLLs here.'''
+
* '''Shell:''' ReactOS Explorer and related shell DLLs (shell32, browseui, stobject...).  
  
 
* '''System DLLs:''' Critical DLLs like hal, ntdll, kernel32, advapi32 and DirectX/WineD3D/OpenGL components.
 
* '''System DLLs:''' Critical DLLs like hal, ntdll, kernel32, advapi32 and DirectX/WineD3D/OpenGL components.
Line 21: Line 21:
 
* '''User-mode DLLs:''' Every DLL that is not critical.
 
* '''User-mode DLLs:''' Every DLL that is not critical.
  
* '''Commands and utilities:''' System accessories, Control Panel applets, external commands, utilities, tools, services...
+
* '''Commands and utilities:''' System accessories, Control Panel applets, Command Prompt, external commands, utilities, tools, services...
  
 
* '''Tasks:''' Syncs with external components (Please add the version of software synced), build improvements and other trivial stuff.  
 
* '''Tasks:''' Syncs with external components (Please add the version of software synced), build improvements and other trivial stuff.  
 +
 +
* '''Outside the tree:''' Mention works here that does not take place in ReactOS Git master branch.
  
 
== How to contribute ==
 
== How to contribute ==
Line 33: Line 35:
 
* We should go progressively as usual. Big additions increase probability of errors.
 
* We should go progressively as usual. Big additions increase probability of errors.
  
* Until a few days before release, add WIP and Upcoming templates on top. Someone will remove them when time comes. When a release is branched, WIP template can be removed.
+
* Until a few days before release, add WIP and Upcoming templates on top. They will be removed when time comes. When a release is branched, WIP template can be removed.
  
 
* Most of the commits include JIRA issues or PR numbers. Have a look at them. You'll better see what is done. Sometimes, devs will include what's fixed. Try to avoid way too technical stuff, and add what's done. Also following JIRA regularly is helpful.
 
* Most of the commits include JIRA issues or PR numbers. Have a look at them. You'll better see what is done. Sometimes, devs will include what's fixed. Try to avoid way too technical stuff, and add what's done. Also following JIRA regularly is helpful.
Line 49: Line 51:
 
* Previous Community Changelogs will give you idea about how to contribute. Don't hesitate to ask for help! And if your English is bad, please request help.
 
* Previous Community Changelogs will give you idea about how to contribute. Don't hesitate to ask for help! And if your English is bad, please request help.
  
* A topic in the forum for every changelog will be opened as usual. You can use it for discussions and your ideas.
+
[[User:Ctasan|Ctasan]] ([[User talk:Ctasan|talk]]) 14:19, 19 August 2020 (UTC)
 
 
[[User:Ctasan|Ctasan]] ([[User talk:Ctasan|talk]]) 21:15, 11 December 2018 (UTC)
 
  
 
{{Navigation Community Changelog}}
 
{{Navigation Community Changelog}}

Latest revision as of 14:20, 19 August 2020

Community Changelogs is free to contribute and use. You just need a Trusted Wiki account, use it wisely. To get it, please contact with Wiki administrators.

Contributions or suggestions on the forum are also accepted.

Structure of Community Changelogs

Community Changelogs are divided into categories indicating which layer of the system is changed in that release.

  • Kernel: It consists of ntoskrnl.exe and modules, FreeLoader (the bootloader) and UEFI loader.
  • Setup: It includes reactos, setup, usetup, welcome, and setuplib stuff (i.e. all ReactOS Setup modules).
  • Win32 subsystem: It includes WIN32K, NTUSER, GDI, USER32, NTVDM, CSRSS etc and internal parts of DirectX. If you see them or similar components, then it goes into Win32 subsystem category.
  • Drivers: All drivers go here. Device, class or filesystem drivers; no matter.
  • Shell: ReactOS Explorer and related shell DLLs (shell32, browseui, stobject...).
  • System DLLs: Critical DLLs like hal, ntdll, kernel32, advapi32 and DirectX/WineD3D/OpenGL components.
  • User-mode DLLs: Every DLL that is not critical.
  • Commands and utilities: System accessories, Control Panel applets, Command Prompt, external commands, utilities, tools, services...
  • Tasks: Syncs with external components (Please add the version of software synced), build improvements and other trivial stuff.
  • Outside the tree: Mention works here that does not take place in ReactOS Git master branch.

How to contribute

  • These entries are not strict rules, you are free. However, we have a style, we're targeting day-to-day users here. Using your common sense is enough.
  • Think a release is done and sometime, two weeks to a month has passed. Firstly, have a look into commit stream and analyze what's important. Some build fixes and a spree of new functions? Choose. On the other hand, a bunch of technical terms? I think you don't want to copy all of the commit message entirely. Instead, try to find a way to convert them user-readable.
  • We should go progressively as usual. Big additions increase probability of errors.
  • Until a few days before release, add WIP and Upcoming templates on top. They will be removed when time comes. When a release is branched, WIP template can be removed.
  • Most of the commits include JIRA issues or PR numbers. Have a look at them. You'll better see what is done. Sometimes, devs will include what's fixed. Try to avoid way too technical stuff, and add what's done. Also following JIRA regularly is helpful.
  • Adding which program is fixed is a bonus. (Example: win32ss/font: Fixed a bug causes Google Chrome not rendering web pages.)
  • Try to avoid using function names, instead collect them into a category that is special enough. (example: iphlpapi: Implemented interface name resolving functions.)
  • Build fixes, translations, glitch/pixel fixes etc. are not so important. Instead, we should focus on fixes and developments. However, if there's something happened that big, you can also add it.
  • Write everything entry by entry. Everywhere you can, write which component or module changed, like Wine commit stream. (example: shell32: Fixed showing disk capacity.)
  • After each entry, add committer name or author of the patch/pull request. If there's a collaborative work, add names accordingly.
  • Previous Community Changelogs will give you idea about how to contribute. Don't hesitate to ask for help! And if your English is bad, please request help.

Ctasan (talk) 14:19, 19 August 2020 (UTC)

Versions / Official Changelogs / Community Changelogs
0.4.x Series 0.4.1 | 0.4.2 | 0.4.3 | 0.4.4 | 0.4.5 | 0.4.6 | 0.4.7 | 0.4.8 | 0.4.9 | 0.4.10 | 0.4.11 | 0.4.12 | 0.4.13 | 0.4.14 | 0.4.15