doc: update some docs for clarity

Author: NotAPenguin0

src/graph/physical_resource.rs

@@ -20,7 +20,7 @@ pub enum PhysicalResource {
 /// ```
 /// use phobos::prelude::*;
 ///
-/// let resource = VirtualResource::new("image");
+/// let resource = VirtualResource::image("image");
 /// let image = Image::new(/*...*/);
 /// let view = image.view(vk::ImageAspectFlags::COLOR)?;
 /// let mut bindings = PhysicalResourceBindings::new();

src/graph/record.rs

@@ -387,7 +387,7 @@ fn record_node<'q, D: ExecutionDomain, U, A: Allocator>(
 impl<'cb, D: ExecutionDomain, U, A: Allocator> RecordGraphToCommandBuffer<D, U, A>
     for BuiltPassGraph<'cb, D, U, A>
 {
-    /// Record the rendergraph to the command buffer. This will pass `user_data` along to every pass executor in the graph.
+    /// Record the render graph to the command buffer. This will pass `user_data` along to every pass executor in the graph.
     fn record<'q>(
         &mut self,
         mut cmd: IncompleteCommandBuffer<'q, D, A>,

src/pipeline/cache.rs

@@ -50,6 +50,8 @@ struct PipelineCacheInner<A: Allocator> {
 /// [`PipelineCache::create_named_pipeline`].
 ///
 /// This struct is `Clone`, `Send` and `Sync`.
+///
+/// This should generally be accessed through a global [`ResourcePool`](crate::pool::ResourcePool)
 /// # Example usage
 /// ```
 /// use phobos::prelude::*;

src/pipeline/mod.rs

@@ -1,9 +1,9 @@
 //! Deals with wrappers for creating and managing Vulkan pipeline objects and their related objects.
 //!
-//! This is a helper that manages creating pipelines, obtaining reflection information from them (if the `shader-reflection` feature is enabled).
+//! The pipeline cache is a helper that manages creating pipelines, obtaining reflection information from them (if the `shader-reflection` feature is enabled).
 //! You probably only want one of these in the entire application. Since it's used everywhere, to ensure safe access
 //! is possible, the inner state of a [`PipelineCache`](crate::PipelineCache) is wrapped in an `Arc<RwLock<PipelineCacheInner>>`,
-//! so this is `Send`, `Sync` and `Clone`.
+//! so this is `Send`, `Sync` and `Clone`. An instance of this is included in the [`ResourcePool`](crate::pool::ResourcePool).
 //!
 //! # Example
 //! The following example uses the [`PipelineBuilder`](crate::PipelineBuilder) utility to make a graphics pipeline and add it to the pipeline cache.
@@ -53,8 +53,8 @@
 
 use ash::vk;
 
-use crate::pipeline::raytracing::ShaderBindingTable;
 use crate::{Allocator, Device};
+use crate::pipeline::raytracing::ShaderBindingTable;
 
 pub mod builder;
 pub mod cache;