https://github.com/discourse/discourse Background I was trying to customize Discourse. (deep customization, theme/plugin is not enough, not a simple facelift change(logo, color, image etc)) I git clone to my laptop and start reading the code. (I am Ruby on Rails dev & newbie Ember.js dev) Question Why there are so little code comment in codebase? (controller / model / view / etc, both Rails and Ember) I get the phrase “good code itself is comment” (or something like that) But why so little? Thanks.

Because comments tend to rot and deprecate which makes them useless (and sometimes counter intuitive) over time.

Thanks for reply But 1-4 line comment per-controller/view/template/etc seem like reasonable number. not too much, not too little :smile:

I hope you guys(Discourse core team) can write few post about the big picture view on Discourse codebase.. (not like “why chose Ember.js” I already read that one. deeper than that) like: Why this folder structure(Ruby on Rails & Ember.js put together) I guess if you guys make Discourse from scratch in 2018, would decide separated Rails&Ember into 2 repo? or different folder structure What’s the different between GlobalSetting & SiteSetting? What’s the core model of Discourse? (Users&Post&Topic)? why preload_script is needed? example preload_script return # ... some other code ".html_safe so it’s for SEO or some other reason? and few other question I couldn’t recall right now

[画像] 1c7: deep customization, theme/plugin is not enough [画像]Creating a gender limited forum? In Discourse a plugin can do almost anything :sparkles: You can/should use plugin.

OK, I would read more into plugin. Thanks for the suggestion Vinoth Kannan

Unless you have a team of full time programmers or want never to take advantage of future upgrades to discourse, you want a plugin. Those who have forked are all sorry. Almost anything can be accomplished with a plugin.

Got it, Thanks! we do want future upgrade, would look into Theme and Plugin. Thanks for reply!

Discourseコードベースのコードコメントがなぜこれほど少ないのか？（GitHub）

開発

vinothkannans (Vinoth Kannan) 2018 年 4 月 19 日午前 10:52 5

You can/should use plugin.

トピック		返信	表示
Learn how to start building stuff for Discourse if you're newbie (like myself) Developers explanation	14	30613	2023 年 10 月 15 日
Some basic questions about discourse and rails Development	3	2094	2017 年 7 月 29 日
Installed Discourse. Need help understanding code structure Development	2	2273	2017 年 1 月 19 日
Developer wanted for Discourse customization! Marketplace	1	859	2019 年 5 月 16 日
Embed Discourse comments with on-page commenting? Feature	32	8593	2019 年 1 月 19 日

Discourseコードベースのコードコメントがなぜこれほど少ないのか？（GitHub）

関連トピック