documentación

app/lib/active_storage/service/jekyll_service.rb

@@ -11,6 +11,9 @@ module ActiveStorage
     # sitio.
     class JekyllService < Service::DiskService
       # Genera un servicio para un sitio determinado
+      #
+      # @param :site [Site]
+      # @return [ActiveStorage::Service::JekyllService]
       def self.build_for_site(site:)
         new(root: File.join(site.path, 'public'), public: true).tap do |js|
           js.name = site.name.to_sym
@@ -20,6 +23,13 @@ module ActiveStorage
       # Lo mismo que en DiskService agregando el nombre de archivo en la
       # firma.  Esto permite que luego podamos guardar el archivo donde
       # corresponde.
+      #
+      # @param :key [String]
+      # @param :expires_in [Integer]
+      # @param :content_type [String]
+      # @param :content_length [Integer]
+      # @param :checksum [String]
+      # @return [String]
       def url_for_direct_upload(key, expires_in:, content_type:, content_length:, checksum:)
         instrument :url, key: key do |payload|
           verified_token_with_expiration = ActiveStorage.verifier.generate(
@@ -61,6 +71,9 @@ module ActiveStorage
       end
 
       # Crea una ruta para la llave con un nombre conocido.
+      #
+      # @param :key [String]
+      # @return [String]
       def path_for(key)
         File.join root, folder_for(key), filename_for(key)
       end