Replication package for the paper "What do Developers Discuss about Code Comments"

<pre><code class="language-markdown"># RP-commenting-practices-multiple-sources Replication package for the paper "What do Developers Discuss about Code Comments?" ## Structure ``` Appendix.pdf Tags-topics.md Stack-exchange-query.md RQ1/ LDA_input/ combined-so-quora-mallet-metadata.csv topic-input.mallet LDA_output/ Mallet/ output_csv/ docs-in-topics.csv topic-words.csv topics-in-docs.csv topics-metadata.csv output_html/ all_topics.html Docs/ Topics/ RQ2/ datasource_rawdata/ quora.csv stackoverflow.csv manual_analysis_output/ stackoverflow_quora_taxonomy.xlsx ``` ## Contents of the Replication Package --- - **Appendix.pdf**- Appendix of the paper containing supplement tables - **Tags-topics.md** tags selected from Stack overflow and topics selected from Quora for the study (RQ1 &amp; RQ2) - **Stack-exchange-query.md** the query interface used to extract the posts from stack exchnage explorer. - **RQ1/** - contains the data used to answer RQ1 - **LDA_input/** - input data used for LDA analysis - `combined-so-quora-mallet-metadata.csv` - Stack overflow and Quora questions used to perform LDA analysis - `topic-input.mallet` - input file to the mallet tool - **LDA_output/** - **Mallet/** - contains the LDA output generated by MALLET tool - **output_csv/** - `docs-in-topics.csv` - documents per topic - `topic-words.csv` - most relevant topic words - `topics-in-docs.csv` - topic probability per document - `topics-metadata.csv` - metadata per document and topic probability - **output_html/** - Browsable results of mallet output - `all_topics.html` - `Docs/` - `Topics/` - **RQ2/** - contains the data used to answer RQ2 - **datasource_rawdata/** - contains the raw data for each source - `quora.csv` - contains the processed dataset (like removing html tags). To know more about the preprocessing steps, please refer to the reproducibility section in the paper. The data is preprocessed using Makar tool. - `stackoverflow.csv` - contains the processed stackoverflow dataset. To know more about the preprocessing steps, please refer to the reproducibility section in the paper. The data is preprocessed using Makar tool. - **manual_analysis_output/** - `stackoverflow_quora_taxonomy.xlsx` - contains the classified dataset of stackoverflow and quora and description of taxonomy. - `Taxonomy` - contains the description of the first dimension and second dimension categories. Second dimension categories are further divided into levels, separated by `|` symbol. - `stackoverflow-posts` - the questions are labelled relevant or irrelevant and categorized into the first dimension and second dimension categories. - `quota-posts` - the questions are labelled relevant or irrelevant and categorized into the first dimension and second dimension categories. --- </code></pre>

# RP-commenting-practices-multiple-sources 论文《开发者们如何讨论代码注释？》的复现包
## 目录结构

Appendix.pdf
Tags-topics.md
Stack-exchange-query.md
RQ1/
LDA_input/
combined-so-quora-mallet-metadata.csv
topic-input.mallet
LDA_output/
Mallet/
output_csv/
docs-in-topics.csv
topic-words.csv
topics-in-docs.csv
topics-metadata.csv
output_html/
all_topics.html
Docs/
Topics/
RQ2/
datasource_rawdata/
quora.csv
stackoverflow.csv
manual_analysis_output/
stackoverflow_quora_taxonomy.xlsx

## 复现包内容
---
- **Appendix.pdf**：论文附录，包含补充表格
- **Tags-topics.md**：为本研究（RQ1与RQ2）从堆栈溢出（Stack Overflow）中选取的标签，以及从Quora中选取的主题
- **Stack-exchange-query.md**：用于从堆栈交换资源管理器（Stack Exchange Explorer）中提取帖子的查询接口
- **RQ1/**：存放用于解答研究问题1（RQ1）的相关数据
- **LDA_input/**：用于潜在狄利克雷分配（Latent Dirichlet Allocation，LDA）分析的输入数据
- `combined-so-quora-mallet-metadata.csv`：用于执行LDA分析的堆栈溢出与Quora问题数据集
- `topic-input.mallet`：Mallet主题建模工具的输入文件
- **LDA_output/**：
- **Mallet/**：存放由Mallet工具生成的LDA分析输出结果
- **output_csv/**：
- `docs-in-topics.csv`：各主题对应的文档列表
- `topic-words.csv`：各主题的核心特征词
- `topics-in-docs.csv`：每篇文档的主题概率分布
- `topics-metadata.csv`：每篇文档的元数据及主题概率信息
- **output_html/**：可浏览的Mallet输出结果页面
- `all_topics.html`：全主题可视化浏览页面
- Docs/
- Topics/
- **RQ2/**：存放用于解答研究问题2（RQ2）的相关数据
- **datasource_rawdata/**：存放各数据源的原始预处理数据集
- `quora.csv`：经过预处理的Quora数据集（已去除HTML标签等）。有关预处理步骤的详细说明，请参阅论文中的可复现性章节。该数据集通过Makar工具完成预处理。
- `stackoverflow.csv`：经过预处理的堆栈溢出数据集（已去除HTML标签等）。有关预处理步骤的详细说明，请参阅论文中的可复现性章节。该数据集通过Makar工具完成预处理。
- **manual_analysis_output/**：
- `stackoverflow_quora_taxonomy.xlsx`：包含堆栈溢出与Quora数据集的分类结果，以及分类体系的说明文档
- `Taxonomy`：包含分类体系第一维度与第二维度类别的说明。第二维度类别进一步划分为多个层级，以`|`符号分隔
- `stackoverflow-posts`：已标记为相关/不相关的堆栈溢出问题，并被归类至第一维度与第二维度类别中
- `quota-posts`：已标记为相关/不相关的帖子，并被归类至第一维度与第二维度类别中