Don't now need to run load(all)

[aidanmews]

"10.3 Run devtools::load_all() followed by ?assemble_crime_data to view the help file generated from the roxygen comments"

"11.5 Save the test file and run devtools::load_all()."

[pbbgss]

@aidanmews I think I may be misunderstanding this issue? If you have a loaded package and make changes to the package components they changes are not inherited by the loaded package

The function devtools::load_all() must be called in 10.3 to load a version of the package with the help file created in 10.2. Otherwise ?assenble_crime_data won't work.

Similarly we need the devtools::load_all() in 11.5 to load a version of the package with the test files created in 11.4 so that we can use them in 11.6.

[aidanmews]

I raised the issue because when running through the training I didn't need to use devtools::load_all() for the ?assemble_crime_data to work. Maybe there's been a change so it's no longer needed?

[pbbgss]

Yea looks like I was wrong about the behaviour - apologies.

It seems that devtools::document() runs devtools::load_all() making the help file available to ?. If you restart R you would then need to run devtools::load_all() before accessing the help.

# Access to help available after running devtools::document()`

> devtools::document()
ℹ Updating psmi documentation
ℹ Loading psmi
Writing NAMESPACE
Writing foo.Rd
> ?foo
ℹ Rendering development documentation for "foo"

# Access lost after restarting R

Restarting R session...

> ?foo
No documentation for ‘foo’ in specified packages and libraries:
you could try ‘??foo’

# Running devtools::document() gives access to help and loads package

> devtools::document()
ℹ Updating psmi documentation
ℹ Loading psmi
> ?foo
ℹ Rendering development documentation for "foo"
> foo()
[1] "foo"
> 

I think it is worth leaving in the devtools::load_all() step as it gets people in the habit of running it after making changes to the package without them needing to remember what the exceptions are?

[aidanmews]

Maybe add a conditional i.e.

"10.3 To view the help file generated from the roxygen comments run ?assemble_crime_data [Note: you may need to first run devtools::load_all()]"