diff --git a/nlohmann_json.podspec b/nlohmann_json.podspec
index 79f81ff9d..49f9fe041 100644
--- a/nlohmann_json.podspec
+++ b/nlohmann_json.podspec
@@ -1,89 +1,51 @@
-#
-#  Be sure to run `pod spec lint nlohmann_json.podspec' to ensure this is a
-#  valid spec and to remove all comments including this before submitting the spec.
-#
-#  To learn more about Podspec attributes see http://docs.cocoapods.org/specification.html
-#  To see working Podspecs in the CocoaPods repo see https://github.com/CocoaPods/Specs/
-#
+# upgrades how to:
+# 1. update s.version
+# 2. run `pod spec lint nlohmann_json.podspec`
+# 3. register a session with cocoapods
+# 4. run `pod trunk push ./`
 
+# see cocoapods documentation http://docs.cocoapods.org/specification.html for
+# more details.
 Pod::Spec.new do |s|
 
   # ―――  Spec Metadata  ―――――――――――――――――――――――――――――――――――――――――――――――――――――――――― #
   s.name         = "nlohmann_json"
   s.version      = "3.1.2"
-  s.summary      = "JSON reader & writer for C++ optimized for ease of use and modern C++14"
+  s.summary      = "JSON for Modern C++"
 
 
   # CocoaPods strips indentation for description
   s.description  = <<-DESC
-    JSON library for c++, it can read & write, uses C++14 features to have
-    modern syntax.
+    JSON library for modern c++, it can read & write JSON. If you know how to
+    use std::vector or std::map, you are already set.
                    DESC
 
   s.homepage     = "https://github.com/nlohmann/json"
   s.screenshots  = "https://raw.githubusercontent.com/nlohmann/json/master/doc/json.gif"
 
 
-  # ―――  Spec License  ――――――――――――――――――――――――――――――――――――――――――――――――――――――――――― #
-  #
-  #  Licensing your code is important. See http://choosealicense.com for more info.
-  #  CocoaPods will detect a license file if there is a named LICENSE*
-  #  Popular ones are 'MIT', 'BSD' and 'Apache License, Version 2.0'.
-  #
-
   license_text = File.read("LICENSE.MIT")
   # cocoapods checks extension and expects it to be a txt. so instead
   # we read the file and pass it in as text.
   s.license      = { :type => "MIT", :text => license_text }
 
 
-  # ――― Author Metadata  ――――――――――――――――――――――――――――――――――――――――――――――――――――――――― #
-  #
-  #  Specify the authors of the library, with email addresses. Email addresses
-  #  of the authors are extracted from the SCM log. E.g. $ git log. CocoaPods also
-  #  accepts just a name if you'd rather not provide an email address.
-  #
-  #  Specify a social_media_url where others can refer to, for example a twitter
-  #  profile URL.
-  #
-
-
-  s.authors            = {
-    "Niels Lohmann" => "nosend@respectmyprivacy.com"
+  s.authors      = {
+    "Niels Lohmann" => "mail@nlohmann.me"
   }
 
-  # ――― Platform Specifics ――――――――――――――――――――――――――――――――――――――――――――――――――――――― #
-  #
-  #  If this Pod runs only on iOS or OS X, then specify the platform and
-  #  the deployment target. You can optionally include the target after the platform.
-  #
-
   s.platform     = :ios, "8.0"
 
-  #  When using multiple platforms
+  # When using multiple platforms. I haven't tested integration with other
+  # platforms. Theoretically it should just work without problem.
   # s.ios.deployment_target = "8.0"
   # s.osx.deployment_target = "10.7"
   # s.watchos.deployment_target = "2.0"
   # s.tvos.deployment_target = "9.0"
 
 
-  # ――― Source Location ―――――――――――――――――――――――――――――――――――――――――――――――――――――――――― #
-  #
-  #  Specify the location from where the source should be retrieved.
-  #  Supports git, hg, bzr, svn and HTTP.
-  #
-
   s.source       = { :git => "https://github.com/nlohmann/json.git", :tag => "v#{s.version}" }
 
-
-  # ――― Source Code ―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――― #
-  #
-  #  CocoaPods is smart about how it includes source code. For source files
-  #  giving a folder will include any swift, h, m, mm, c & cpp files.
-  #  For header files it will include any header in the folder.
-  #  Not including the public_header_files will make all headers public.
-  #
-
-  s.source_files  = "single_include/**/*.hpp"
+  s.source_files = "single_include/**/*.hpp"
   s.public_header_files = "single_include/nlohmann/json.hpp"
 end