Skip to content

Conversation

@ardier
Copy link
Contributor

@ardier ardier commented Aug 5, 2025

This pull request updates the FuzzBench documentation to provide clearer and more comprehensive instructions for running and submitting experiments, especially when contributing via pull requests. The main focus is on clarifying the workflow differences, experiment naming requirements, and artifact submission process for external contributors.

Documentation improvements for experiment submission:

  • Added a new "Submitting Experiments via Pull Requests" section to running_an_experiment.md, detailing the workflow, experiment name requirements, artifact submission, and log access for contributors submitting experiments through GitHub PRs.
  • Updated adding_a_new_fuzzer.md to reference the new instructions for submitting experiments via pull requests, improving discoverability and guidance for new contributors.

General documentation enhancements:

  • Expanded the introduction to run_experiment.py in running_an_experiment.md to explain its purpose and workflow, helping users understand how experiments are started and managed in FuzzBench.

@ardier
Copy link
Contributor Author

ardier commented Aug 5, 2025

Here is the associated issue.


## Configuration Files For Cloud Experiments

Fuzzer configuration files (e.g., `--fuzzer-configs`) are still supported for **offline/local experiments**. However, these have been deprecated for Google Cloud-based experiments run by the FuzzBench service. For cloud experiments, provide configuration parameters via your benchmark or fuzzer scripts directly.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hmm...not sure this part is correct. I'm going to leave it out.

Removed deprecated information about fuzzer configuration files for cloud experiments.
@jonathanmetzman
Copy link
Contributor

Thank you. Sorry for the delay while I was out (and a little after :-)

@jonathanmetzman jonathanmetzman merged commit 3f53bed into google:master Dec 31, 2025
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants